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RANDOM T^T^or-FRSmrx AND THE 1301 IOCS 



This section describes how random 

Dlications are handled by the 1301 I 



In-Line Processii^ 



•It 



iroach to disk processing is 



In this type 



The most elementary £ 

known as "in-line processing 

plication , information is obtained from disk storage 

by SEEK and READ commands that are part of the 

main routine. Processing halts . therefore, each 
time a disk SEEK, READ or WRITE operation takes 
place , and processing does not resume until the 
desired disk information has been obtained. 

Figure 2 illustrates this method of disk proces - 



sing 



calls 



(1) readily of a transaction record; 

(2) retrieval of the corresponding information 
from disk «tor^e ; 

(3) updating of this information, and 

(4) return of the updated information to disk 

storage . 
NOTE: A good example of this type of applic 



inventory 



This 



up- 



part 



storage) on the basis of receipts and disburse- 



parts 



> 



transactions 



Up- 



dating takes place as soon as transactions 

have occurred, and in this manner the inven 

tory file is kept currently up to date . 



Information Retrieval Only 



special case of in-line processing calls only 



information 



information 



obtained from disk storage , but it is not updated and 
it is not written back onto the disk. See Figure 3. 



I 



Summary of In-Line Processing 



In 



Start 




Initialize 





Transaction 




Develop 

Disk Address 



Seek and Read 
Disk Record 




the most wasteful use of disk storage. 



wasteful 



stands 



during the disk SEEK, READ and WRITE 
This halt in processing occurs because tl 
tions calling for these disk operations ar 

the main routine. 



Complete 

House- 
keeping 



Overlapping of SEEK Operations 




time-consumii^ 



SEEK, which requires from to 180 milliseconds 



Figure 2. Random Processing - Type 1: In-Line Processing 
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Get Next 

Transaction Recor 




1 



Develop 
Disk Address 




1 



Seek and Read 

Disk Record 





1 



Put Report Record 



Yes 




No 




Halt 



(1. e. , 180, 000 microseconds) . * The coding re - 

quired to handle the simultaneous execution of sev- 
eral SEEK operations constitutes a considerable 

programming task. The maintasks thatmustbe ac- 
complished are; 

(1) the retention, or "stacking," of successive 
transaction records until they can be proc- 
essed; 

(2) the holding of disk records obtained by the 

various SEEK and READ commands until these 

records can be processed; 
(3) provisions insuring that disk records are up- 



transaction 



and 



(4) 



after 



transaction records and 



The 1301 IOCS provides all the functions listed 

above , as will be explained in the next section. 



SEPARATION OF THE DISK ROUTINE FROM 
MAIN ROUTINE 



ran 



obtain 



dom-proces,sing applications are illustrated in 

Figure 4. Note that all instructions needed to 

or process disk data (henceforth referred to collec- 
tively as the "Dislc Routine") have been removed from 
the main routine. 



Although 



two 



one another: 



and 



transaction records independently of any processing 

in the Disk Routine, and the Disk Routine obtains 
successive transaction records from the work area 
independently of processing in the main routine. 

NOTE: Separation of the Disk Routine from the 

main routine is possible only if processing in 

the main routine does not depend on the informa- 
tion obtained by the Disk Routine. The most 

widely used applications of disk storage , such as 

inventory control and information retrieval, 

permit this approach. 

The different program steps , as executed by the 

1301 IOCS, are indicated in Table I. 



Figure 3. Random Processing - Type 1: Information Retrieval Only 



*Since a module of IBM 1301 Disk Storage has only one access arm, 
multiple SEEKs can be used and overlapped only if the program 

uses more than one module of 1301 Disk Storage. 
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Main Routine 



Disk Routine 



TEST OF 
WORK AREAS 

See also 
Figure 5. 



The main routine obtains a trans- 
action record , stores it in Work 

Area I, and branches control to 

the Disk Routine. 



If no disk record is ready for proc- 
essing and a segment of Work 

Area I is available , control will be 

branched to the main routine: 



Processing now continues at Point 

A (return address of the main 

routine) . In Figure 4 , this is the 

branch to the instruction that calls 
for the reading of the next transac- 
tion record. This transaction 

record is now moved to a free 
segment of Work Area I, and con- 
trol is branched to the Disk Routine . 
(In this manner , the main routine 
initiates the reading and processing 
of each disk record required by a 

given transaction record. ) 

sing then continues as described 

above. 



ing continues in the Disk 

until the SEEK and READ 



and is encoimtered 



Routine 



and 



If a previously read disk record is 

ready for updating, processing 
continues in the Disk Routine 

(Point B) : ^ 



The waiting disk record is updated 

with the correct transaction data, and 



the WRITE operation that will write 

the updated disk record back into disk 

storage is initiated. (As indicated in 

Figure 4, the segment of Work Area n 

that contained the just-updated disk 
record will be released upon completion 



WRITE 



Processing 



in the Disk Routine now continues: any 

needed report is written, and the segment 

of the transaction stacking area that held 

Proces- the transaction record used to update the 



disk record is released. The test of 
the work areas indicated above is then 
made again, and control is branched to 
either (A) or (B) , depending on the 
outcome of the test, as described above. 



Table I. Program 



Summary of Main IOCS Fimctions for Random 
Processing 



As indicated in Figure 4 and the subsequent descrip- 
tion, the IBM 1301 IOCS accomplishes each one of 
the tasks that were characterized above as necessary 
prerequisites for the simultaneous execution of 
several SEEK operations. The following summarizes 

these functions of the 1301 IOCS: 



1. 




The retention, or "stacking," of successive 
transaction records until they can be processed. 

As indicated in Figure 4, successive trans- 
action records are stored in a work area , which 

will henceforth be called the "Transaction 
Stacking Area, " Whether a new transaction 



record is to be stored or a disk record is to be 



determined 



and 



processing of the transaction is completed. 

The updating of a disk record ready for 

processing takes precedence over the reading of 



transaction 



Only 



and 



ment of the Transaction Stacking Area is avail- 
able, is control passed back to the main routine 



(and storing) of another trans 



action record. 



two transaction 



same 



does not process the second request until proc - 
essing of the first has been completed.) See 
Figure 5. 



Random Processing and the 1301 IOCS 
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MAIN ROUTINE 



Sfe- 



DISK ROUTINE 



Yes 





GET 



next trans- 



action record 





Move transaction 

record to Work 

Area I 




Branch to 

Disk Routine 






C) A 




Complete 

Housekeeping 





r 



I 1st segment | 



I- 



j 
I 



•^ 2nd segment I 



I 

I- 

I 



J 
I 





I 

I nth segment I 

I I 



WORK AREA I 



r 



n 



I 1st segment 



r- 

I 2nd 
I 



segment 






L 
I 



J 
I 



I nth segment I 

I I 



WORK AREA II 




Store 
return address 



Develop disk 

address from 

data in Work 
Area I 



Branch 
Control 
to A or B 



(see text) 





Initi ate ' C om pi ete j 
SEEK I READ / 






♦::- 



B 




Update disk record in 
Work Area II using 
transaction record in 
Work Area I 




Complete 

Initiate |WRITE 



WRITE 



Release 

Work Area 



II 





PUT 
report 




Branch 
Control 

to A or B 
(see text) 




Figure 4. Separation of the Disk Routine from the Main Routine 
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Branch to 

(B)in 
appropriate 

Disk Routine 



foanch to (A) 
following last 

executed branch in 

Main Routine 



Figure 5. Control Switching 



2 



3 



4. 



The holding of disk records obtained by the 

various SEEK and READ commands until these 



can 



As indicated in Figure 



in another 



which 



Record Holding Area. " The 



until 



required. 



Func 



Macro 



detailed description of the release procedure of 

disk records . 

Provisions insurir^ that disk records are update 

with the correct set of transaction data. 



Figure 



Routine 



simultaneous execution of several SEEK and 
READ commands. As described, each time a 
disk record has been successfully sought and 
read, it is made ready for updating. The 1301 
IOCS insures that whenever control is branched 

to the Disk Routine for the updating of a disk 

record , this disk record is updated with data 
from the correct transaction record stored in 
the Transaction Stacking Area. 

Release of work areas after their contents are nc 

longer required. Segments of the Transaction 
Stacking Area are released upon completion of 
processing in the Disk Routine. Segments of the 
Disk Record Holding Area are released at the 
completion of each WRITE operation, and as 

explained under "Additional Functions of the 
FSEQP Macro-Instruction. " 



Sequence of Disk Operations 



Although transaction 



m 



the main routine , updated disk records are not neces- 
sarily written back onto the disk in the same order. 



inform a 



tion in disk storage. Information access time de - 
pends not solely on the order in which disk requests 
are given but also on the location of the requested 

information in disk storage. 



exa: 



fore the first. 



information with an access time of 100 ms, and 10 m 
later another arm receives a request with access 
time of 50 ms, the second request will be met be- 

In this case, the disk information re- 
quested last will be obtained before that requested 
just prior to it. 

If disk records are to be processed in the same 

order as the incoming transaction records, proces- 
sing of the data obtained by the second arm in the 

example must be delayed until the data obtained by 

the first arm has been processed. 



Disk IOCS Macro -Instructions 



f 



The 1301 Disk IOCS permits the use of the following 



macro-instructions: 



% 



OPEN "Open Disk File(s)" 

This macro -instruction may be used tS o^en disk 

files used for random or sequential processing. 




CLOSE "Close Disk File(s)" 




Ti 



This macro-instruction may be used to close disk 
files used for random or sequential processing. 



MVRSA "Move Record to Stacking Area" 

This macro-instruction may be used to move 



Area. 



Transaction Stacking 
for random processing 



.-I 



ENTDR "Enter Disk Routine" 

This macro-instruction may be used to enter the 



main routine. 

processing. 



and store the return address to 1 
It can be used only for random 



GET "Get Disk Record" 

This macro -instruction may be used to seek and 
read disk records. It can be used only for random 
and sequential processing. 



FSEQP "Force Sequential Processing" 



can 



records are processed sequentially, i.e. , written 
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I • 



^ 



MAIN ROUTINE 



DISK ROUTINE 




-^ 



Initiali2e 
incl. 

OPEN 





GET 

next trans- 
action record 





MVRSA 




Branch 

to 

Disk Routine 



m^f 






-■-:-: ----^ 



_-_ 






■■■ii 



.;S;-:: 



• - • -.- 









,■:: 



m^M 



■■.:;'^: 



-'iVr 



^'i. 



MM 



liiiiiiiiiMimri 



..'j'.-^- ..-. 



<5D A 




UK 



V-'. 



Develop 
Disk Address 



Br an ch 
Control 

to A or B 




IIP 



Complete 

Hotisckeeping 
incL 

CLOSE 




Branch 
Control 
to A or B 





-- ■■■..■r;::L>:^i:v]-i^>^:..::i:|::i^ 







, J 




■_ , 



■iV, 



::"^.-':-n''"-";;;'^^'.!' , 




^^j^ 



-^■^■■^^---=-^^-^^ 



Figure 6. The 1301 IOCS Macro^Instructions for Random Processing 
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back onto disk storage in the same order in which 

their corresponding transaction records^ were ob- 
tained by the main routine. This macro-instruc- 
tion can be used for random processing only. 



PUT "Put Disk Record" 

This macro-instruction may be used to write a 

single disk record. It can be used only for random 

and sequential processing. 



LEVDR "Leave Disk Routine" 

This macro-instruction may be used to release the 

segment of the Transaction Stacking Area just pro- 
cessed and to return control to the main routine. 

It can be used only for random processing. 




ek a 



GETS "Get Single-Reference" 

This macro-instruction may be used to 

specified disk cylinder or to seek and read a single 

disk record, a full track, or a full cylinder (op- 
tional feature). 



PUTS "Put Single-Reference" 

This macro-instruction may be used to seek a 
specified disk cylinder, to write a format track, 
or to seek and write a single disk record, a full 

track or a full cylinder (optional feature). 



WAITS "Wait" 

This macro -instruction may be used to develop 

the coding required to suspend processing until 

a specified disk record has been read into core 

storage or written onto disk storage. 



Summary of Macro -Instructions 



The use of the 1301 IOCS macro -instructions for 

random processing is summarized in Figure 6. A 
detailed description of each macro -instruction may 
be found in the section on "The Eleven 1301 IOCS 
Macro-Instructions. " 



INDEPENDENT DISK ROUTINES 



The applications discussed above use only one Disk 

Routine , and all information obtained by the disk 

arm(s) from the Transaction Stacking Area was 

always used by the same set of instructions. 

Some applications require two (or more) independ - 
ent Disk Routines. A typical application of this type 



is the updating of a job record and an employee 

record on the basis of one transaction record. Both 

routines use the same Transaction Stacking Area. 

See Figure 7. 

As indicated in Figure 7, the same set of trans- 
action data is required by more than one Disk Rou- 
tine. The 1301 IOCS insures that no segment of the 

Transaction Stacking Area is released until all Disk 

Routines requiring data from this segment have been 
completed. The IBM 1301 IOCS can handle any 

number of independent Disk Routines. 



DEPENDENT DISK ROUTINES 



Some applications use data from one transaction 

record to update two dependent disk records. Two 

records are considered dependent on one another if 

neither of them can be updated without data from the 

other. When dependent records are processed, both 

disk records must be obtained before either of them 

can be updated. This requires that disk records be 

retained in the Disk Record Holding Area until all 

Disk Routines requiring data from the same Holding- 
Area segment have been completed. The 1301 IOCS 

insures this. 

The first FSEQP macro -instruction in Figure 8 is 

needed to retain the disk record obtained by Disk 

Routine A for use by Disk Routine B. The second 

FSEQP macro -instruction is used to synchronize the 
output of Disk Routine B with the incoming trans- 
action records. 



functions 



FSEQP 



Functions of the FSEQP Macro -Instruction 



NOTE 1: The O] 

indicated. In 

information fi 



takes 



tion until the updated information is returned tc 

storage. This eliminates SEEK time for PUTs 

since the disk arms are already in position. 



NOTE 2: 



can handle 



of dependent Disk Routines. 
^It is possible to contain a random Disk Routine 

within a real-time routine. The following three 

points must be observed: 

1) the MVRSA macro-instruction must be con- 
tained within the real-time routine, 2) care must be 

taken that real-time interrupts do not cause the Disk 

Routine to be executed before the disk file has been 

opened and after it has been closed and 3) when the 

Disk Routine requests exceed the number specified in 

the 'RNDMDEPTH' DIOCS entry, the.real-time 

routine will control until more random disk requests 

may safely be accepted. 
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MAIN ROUTINE 



DISK ROUTINE B 



DISK ROUTINE A 



Yes 





Initialize 
incl. 

OPEN 





GET 

next trans- 



action record 





MVRSA 




Branch to 

Disk Routine 
A 




A 



1 



Branch to 

Disk Routine 

B 



»;> 



A 



2 




Complete 
Housekeeping 
incl. 

CLOSE 





ENTDR 




Develop 

Disk Address 



Branch 

Control 



to A2 or B- 





GET FILE 1 



Initiate . Complete 

SEEK ' READ 





PUT FILE 1 



Initiate 
WRITE 








Complete \ 
WRITE 

Release / 
Holding / 

I Area y 



PUT A 

report / 

3_ 



Branch 
Control 

to A2 or B« 



LEVDR 

Release 
Stacking Area 



Branch 
Control 



to A* or B^ 



ENTDR 




Develop 
Disk Address 





GET FILE 1 

I 






PUT FILE 1 



Initiate 

WRITE 



I Complete 
' WRITE 

Release 
Holding 
Area 





PUT 
report 




Branch 

Control 



to Aj or B 




Figure 7. Random -Processing — Two Independent Disk Routines Use Data Obtained by the Main Routine 
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DISK ROUTINE B 



DISK ROUTINE A 



Yes 



Branch to 

Disk Routine 

A 




A 



1 



Branch to 

Disk Routine 
B 




A 



2 




Branch 
Control 



to A or B 2 




Branch 
Control 



to A2 or Bo 



Branch 
Control 
to A or B 




ENTDR 




Develop 
Disk Address 





GET FILE 2 



Initate 
SEEK 



Complete^ 
READ 





PUT FILE 2 



Initi ate 



WRITE 



Complete 

Write 

I Release 

' Holding 
I Area 




i 




PUT 



Initi ate 



WRITE 



FILE 1 

I Complete 

WRITE 
.Release 
I Holding 

Area 




I 



PUT 

report 



i 




LEVDR 

Release 
Stacking Area 



Branch 
Control 



to A or B. 



Branch 
Control 



to A. or B^ 
1 4 



Branch 
Control 




to A| or B 



i 



ENTDR 




Develop 
Disk Address 




GET FILE 1 



Initate 
SEEK 



I 



Complete 
READ 





Figure 8. Random -Processing - Two Dependent Disk Routines Use Data Obtained from the Main Routine 
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SINGLE-REFERENCE PROCESSING AND THE 1301 IOCS 





Get Transaction 
Record 





ii 



iw^^ 




1 



i 



Seek and Read 
Disk Record 





1 



:■* 



r 




PUTS 





^mm 



Seek and Put 
Disk Record 





Complete 
Housekeeping 



-^Halt j 



This section describes how single-reference proces- 



can 



METHOD 1 



Figure 9 illustrates one method of single -reference 
processing available to users of the 1301 IOCS. 
It will be referred to as ^^Method 1. " 

As shown in Figure 9, Method 1 falls into the 
category of "in-line processing" described above 
because processing halts while a disk SEEK, READ, 

or WRITE operation is in process. 

As indicated, the program reads a transaction 

record and develops the address of the disk informa- 
tion required to process the record. If a SEEK for 
the same record is not already in progress, a SEEK- 
and-READ command for the record is initiated, and 
processing halts until the record has been read into 
core storage. The record is then updated, put back 
into disk storage , and the next transaction record is 
read. 

The shaded areas in Figure 9 indicate the functions 
that are performed by the GETS and PUTS macro- 
instructions when the programmer chooses this 
method of single-reference processing. See the 
sections on the GETS and PUTS macro -instructions 
for a detailed description of the functions of these 
macro-instructions. 



A 



) 



Figure 9. Method 1 of Single-Reference Processing 
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Figure 10. Method 2 of Single-Reference Processing 



Figure 10 illustrates a second method o± single - 
reference processing available to users of the 1301 
IOCS. This method will be referred to as "Method 2." 

As illustrated, Method 2 enables the user to over- 
lap the SEEK and READ operations of the disk SEEK- 

READ operation with processing — provided such 
processing does not require the disk record for which 

the SEEK was initiated. 

As shown in Figure 10, the program reads a trans- 
action record and develops the address of the disk 
information required to process the transaction rec- 
ord. If a SEEK for the same record is not already 
in progress, the SEEK is initiated. As soon as this 
has been done, processing resumes and continues 
until an interrupt signal provided by the 1301 IOCS 
indicates that the SEEK has been completed. The 



resiunes 



READ operation is then initiated, and 

READ 



READ 



operation has been completed. 



READ 



informa- 



tion is needed by the program. This permits over 



and 



processing, as described. If the disk record has 
not yet been obtained when it is needed by the pro- 
gram , the latter enters a waiting loop until the re( 
ord has been obtained. At this point. Method 2 
assumes the characteristics of in-line processing 



until 



record has been obtained. 
NOTE: Wlien Method 2 



Figure 



pletion of the disk READ operation must be 
provided by the user unless he uses the WAITS 
macro-instruction. For details, see the des- 



SWITCH 



WAITS 



struction. 
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BASIC PRINCIPLES OF THE IBM 1301 IOCS 



Relationship of Card/Tape IOCS to 1301 IOCS 



gments the IBM 1410 Card/Tape 



by adding t 

le IBM 1301 Disk Storage in the resxdting 

IBM 1410 Input/Output Control System . 



The 1301 



IOCS furnishes the, error routines and the disk arm 

and file schedulers for random, sequential, and 

single-reference processing. The Card/Tape IOCS 

provides the remaining routines required to include 

1301 Disk Storage in the general IBM 1410 IOCS. 

See Figure 11. 
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Scheduler 





Random Proc- 
essing Routine, 
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Scheduler 
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Unit Record 
File Scheduler 
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Schedulers 
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I 



Single-Reference 
Routine 



Sequential - 
Processing 

Routine, in- 
cluding FILE 

Scheduler 




L 



1410 CARD/TAPE IOCS 



1 



Disk Error 
Routine 



1301 IOCS 



The IBM 1410 Input/Output Control System 



Figure 11. Relationship of the IBM 1410 C/T IOCS to the 1301 IOCS 
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program 



READ or WRITE 



(1) 
(2) 



output 



handle 



specified operation is available. 



The disk arm schedulers then pass the request on 

the channel scheduler furnished by the Card/Tape 



IOCS. 



Advantages of the 1301 IOCS 



IBM 1301 Disk Input/Output Control System con 
5 of a set of tested routines that free the user 
1 all coding of input and output routines for EBM 

Disk Storage. 



Random Processing 



The 1301 IOCS provides the coding required for the 
simultaneous execution of any nxmiber of SEEK, 
READ, and WRITE operations and for the over- 
lapping of all disk input and output operations with 
processing. 



Sequential Processing 



programmer to handle 



logical records in sequential applications merely by 
using GET and PUT and related macro-instructions. 



him of all blocking and 



of disk records. 



Single -Reference Processing 



Available IOCS Routines 



automatically 



schedule several SEEK-and-READ operations 

for simultaneous execution; * 
overlap disk input/output operations with proc- 
essing; 

• schedule all available arms of the 1301 Disk 

Storage Units; 

seek, read and write disk records; 

• check for read and write errors; 

correct (all correctable) read and write errors, 

and 

block and deblock sequential disk records. 



Substantial Savings 



an efficient input/output 



permitting 



The 1301 IOCS provides input/output and error-che 

ing routines for single -reference processing. The 
IOCS also furnishes an interrupt signal upon com- 
pletion of each SEEK, READ and WRITE operation 

The user has the option of 



(1) having 



until each SEEK, READ or WRITE 



(2) 



operation is completed, or 

using the interrupt signal furnished by the 1 

IOCS to test whether READ operations have 

been completed. 



NOTE: The coding required for this test can be 
furnished by the WAITS macro-instruction. 



including 



programmir^ 



providing 



functions, the IBM 1301 Input /Output Control System 

offers users substantial savings in program writing, 

testing and operating expenses. 



Using the 1301 IOCS 



For Random and Sequential Processing 



For each such program that is to utilize the 1301 
IOCS, the programmer must: 

(1) use the appropriate 1301 IOCS macro- 
instructions in his program; 

(2) write the required DIOCS entries; 

(3) write the required DTF entries, and 

(4) write DA (Define Area) statements for the 

Transaction Stacking and Disk Record Holding 
Areas used by his program. 



For Single-Reference Processing 



For each such program that is to utilize the 1301 

IOCS, the programmer must: 

(1) use the GETS and PUTS macro-instructions in 

his program; 

(2) write the required DIOCS entries; and 

(3) write DA (Define Area) statements for the 

Holding Area Control Records used by his 

program. 



Basic Principles of the IBM 1301 IOCS 
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Assembly of Programs Using the 1301 IOCS 



The DIOCS and DTF entries are punched into IBM 

cards and must precede the source program during 

Autocoder assembly. The DIOCS cards are entered 

following the DIOCS header card of the Card/Tape 

IOCS. The DIOCS cards of the two systems may be 

intermixed. 

The required sets of disk DTF cards, each preceded 

by the appropriate disk DTF header card, are entered dtf sets may be 



1410 Program 
including 
DAs & IOC S 



Macro - 
Instructions 



One set of DTF 

entries for each file. 

(Card, tape and disk 



nth set DTF 



entries 



two 



Card/ 
. See 



intermixed. ) 



nth DTF header 




Tape IOCS. The 

Figure 12. 

The remainder of this publication consists pri- 
marily of a detailed explanation of the four program- 
ming steps required to utilize the IBM 1301 Input/ 

Output Control System, namely, the writing of: 



1st set DTF 



Card, tape and disk 
DIOCS cards may 
be intermixed. 



entries 




1st DTF header 




DIOCS entries 



Control Cards 




1. 



instructions 



2. DIOCS entries; 

3. DTF entries; and 

4. DA entries. 



that may be 

included 



information 




£ DIOCS header 



»^ li 



COMMENTS 




regarding 

and a brie 



I 



AUTOCODER 
RUN 



Figure 12. Assembly of Programs using the 1410 Card/Tape and 1301 



Disk IOCS 
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MACRO -INSTRUC TIONS 



RANDOM 



macro 



OPEN 
CLOSE 
MVRSA 
ENTDR 

GET 
FSEQP 

PUT 
LEVDR 



random process! 

"Open File(s)" 

"Close File(s)" 



"Move Record to Stacking Area 

"Enter Disk Routine" 

"Get Logical Record" 

"Force Sequential Processing" 

"Put Logical Record" 

"Leave Disk Routine" 



SEQUENTIAL 



The four macro- 



instructions for sequential processing are: 



OPEN 
CLOSE 
GET 
PUT 



"Open File(s)" 
"Close File(s)" 
"Get Logical Record" 

"Put Logical Record" 



FOR SINGLE-REFERENCE PROCESSING: The 

three macro-instructions for single-reference pro- 
cessing are: 

GETS ' 



PUTS 
WAITS 



"Get, Single Reference" 
"Put, Single Reference" 



t 



'Wait, Single Reference" 



macro 



OPEN 




Label 



jvx.i,/r.0^.c. . 




J I L 



X 



i— i , -L 



A^r.L.f^.e^eA 



perat 




I 



££ 



12 



1& 



±S. 



OPERAND 

_4a 



X—i I— L 



EJUL 



J l_l — 1 — L 



J \ — L 



j_i-^ 



Dl.5.ff.i^J4^.e 



■ ^ * 



' ■ 1 J— J 1 1 L 



I ' ' ■ ^ 



' ^ * 



' ' ' ■ 1 i. 1 i ->■l- 
| I ' * T ' I > i i i 1 \ I 1 1 J L 

I ■■»■ ■■'■ t ■■■''■ ■ — I I I I I I ' ' I ■ I ' 



must be those used to describe the £ile(s) in the DTF 

header line. If more than one file is named in the 

operand, the names must be separated by commas. 

Only one OPEN macro-instruction is needed to open 

all files used by the program, including any non-disk 

files. 



What This Macro Will Do 



; AND SEQUENTIAL PROCESSING, 
named in the operand of the macro 



For 



tion, the 1301 IOCS ~ on the basis of the information 
contained in the DTF entries — will: 

(1) make the appropriate Disk Record Holding 

Area available; 

(2) insert a Group Mark with Word Mark immedi- 
ately to the right of each segment of the Disk 

Record Holding Area; and 

(3) move the Word Marks specified in the first 

section of the Disk Record Holding Area into 

all other sections of the Disk Record Holding 

Area. See Figure 14. 



By using the OPEN macro-instruction, the program- 
mer can let the 1301 IOCS handle the various initial- 
izing tasks which must be performed before data on a 
disk file can be used by the object program. These 
initializing functions differ for random and sequen- 
tial processing and are explained separately below. 

The OPEN macro -instruction must be given in the 
main routine and is written as indicated in Figure 13. 



name 



operand in Figure 13 contains the name or 
of the file(s) to be activated. The name(s) 



RANDOM PROCESSING. The OPEN macro-instruc- 
tion will cause the Transaction Stacking Area to be 

made available for incoming transaction records. 



SEQUENTIAL PROCESSING. The OPEN macro- 
instruction will cause the track address of the first 

record of the file to be inserted into the Track Ad- 
dress Counter of the 1301 IOCS. The initial track 

address is obtained from the information supplied 

by the DTF 'FILESTART' entry. 
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Word Marks 

specified by 

the programmer. 



WM 




WM 



1st Segment of Disk Record Holding Area 



WM 



WM 



Segment 



WM 

GM 



n 



WM 



3rd Segment 




Word Marks inserted by the 
OPEN macro-instruction. 





WM 



WM 



nth S e gm ent 



WM j 

GM I 

I 



Disk Record Holding Area 



Group Marks with 

Word Marks in- 
serted by the OPEN 

macro- instruction. 



the names must be separated by commas. Any file 

used by the program, including any non-disk files, 

may be named. See Figure 16. 



Line 
5 5 



2 



Label 



15 



15 



0... ^.K y LA,&,E,L, . 



J L 



le 



p«rati 



'^ 



C.L.O.5^ 



OPERAND 



20 21 25 30 35 4fi £5 £2 



\ J I I 1 1 — ». 



J I i L 



J I 1 1 1 1. 



This area must be specified by the programmer by means of an 
appropriate DA (Define Area) entry. See section describing 

"Define Area Entries Needed to Support the IOCS. " 



Figure 16, 



Figure 14. Word Marks and Group Marks inserted by the 

OPEN macro-instruction 



CLOSE 



The programmer may use the CLOSE macro-instruc- 
tion to have the 1301 IOCS develop all the coding re- 
quired to close the disk file(s), i. e. , to remove the 

disk file(s) from use by the object program. The 
CLOSE macro-instruction must be given in the main 
routine and is written as indicated in Figure 15. 



o.t. ^.^y.LA.&xs.u. 



Line 



2 



3 
4 



Label 



Operation 

i5l6 J02 



^ i. 



* ^ ■ 
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J^^J l_-^l 1 I I L 



C.L.o.5€ 



^— i L 
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1& 
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Figure 15. 



The operand in Figure 15 contains the name or 

names of the file(s) to be closed. The name(s) must 

be those used to describe the file(s) in the DTF header 
line. If more than one file is named in the operand, 



What This Macro Will Do 



RANDOM AND SEQUENTIAL PROCESSING. The 
1301 IOCS will develop all the coding required to: 

(1) check whether all pending disk operations in- 
volving the files named in the operand have 
been completed, and 

(2) close the file(s) named in the operand after all 

pending disk operations have been completed. 



SEQUENTIAL PROCESSING. The 1301 IOCS will 

develop all the coding required to: 

(1) check whether partially filled output blocks 

remain to be written on the output file(s) 

named in the operand of the macro-instruction; 

(2) write out any partially filled output blocks; 

(3) pad partially filled output blocks with the char- 
acter specified by the DTF "PADDING" entry; 



and 



blanks 



the DTF "PADDING" entry was omitted. 
NOTE 1: The following characters may not be used 

for padding: Asterisk, Tape Mark, Word Sepa- 
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f 



r 



rator Character, Record Mark, Cent Sign and 
Group Mark. 



NOTE 2: When a sequential input file is closed by 
means of the 1301IOCS 'CLOSE' macro-instruction, 
the last address written will be made available 



two 



1) a message contain- 



typed 



printer and 2) the address will be stored within 
the IOCS. The field within the IOCS that will 
contain this address is labeled 'lOCSCLFLD'. 
It is a 26-position field. The label refers to the 
high-order position of this field. The address 
may be used by the next program to specify file 
limits for other sequential files. In the case of 
single-record operation, however, the record 
address supplied in the message does not necces- 
sarily apply to the final address or any address 



ram 



MVRSA (Move Record to Stacking Area) 



mam 



by the Disk Routine(s) must be placed into the Trans- 
action Stacking Area. This insures that the main 
routine does not alter the data before it has been 
used by the Disk Routine(s). This transfer of data 

from the main routine to the Disk Routine(s) permits 
the separation of the Disk Routine(s) from the main 

routine discussed above. 

The programmer may use the MVRSA macro- 
instruction to transfer data developed in the main 
routine to a segment of the Transaction Stacking 
Area specified by the DIOCS ^^STKAREA'^ entry. The 



data will be retained in the Transaction Stacking Area 
until all disk operations using the data have been com- 
pleted. 



MVRSA 



main routine before control is branched to the Disk 

Routine. See Figure 17. 

The two formats of the MVRSA macro-instruction 

are written as indicated in Figures 18 and 21. 



Format A 



Format A is written as indicated in Figure 18. The 
operand identifies the high-order position of the area 
from which information is to be moved to the Trans- 
action Stacking Area. The areas from which infor- 
mation is to be moved must have a Record Mark or a 
Group Mark with Word Mark immediately to the right 
of the low-order position. See Figures 19 and 20. 



Line 

3 5 



0.±x 



2 



Label 



IS 



16 
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J i L 



I 1 1 



J ■ 



perati 



20 
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21 



li 



30 
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Figure 18. 



M 



A 



INFOLABEL 



INFOLABEL + 80 



Figure 19, Area Referred to by the Operand of the MVRSA 

Macro -Instruction 



WM 
GM 



INFOLABEL 



INFOLABEL + 80 



Figure 20. Area Referred to by the Operand of the MVRSA 

Macro-Instruction 



r 



MAIN ROUTINE /^tart^ 









next trans- 
action record 




Branch 
to 

Disk Routine 




A 



DISK ROUTINE 




Figure 17. Use of the MVRSA Macro-Instruction 



What This Format of the Macro Will Do 



This format of the MVRSA macro-instruction will 
cause the 1301 IOCS to: 

(1) select an available segment of the Transaction 
Stacking Area specified by the DIOCS 



T! 



STKAREA^' entry; 



(2) have the program enter a waiting loop if no seg- 
ment of the Transaction Stacking Area is avail- 
able; 

(3) insert the address of the selected segment into 
the indexing register specified by the DIOCS 

'^STKINDEX" entry; and 

(4) move the information and the Word Marks con- 
tained in the area specified by the operand into 
the segment of the Transaction Stacking Area 
selected by the 1301 IOCS. 
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Format B 



DISK ROUTINE 



Format B of the MVRSA macro-instruction has no 

operand and is written as indicated in Figure 21. 



Line 

13 5 



Label 



15 



16 
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2 



1 I 



■ ■ * t 
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Figure 21- 



This format of the MVRSA macro-instruction en- 
ables the programmer to move information into the 
Transaction Stacking Area by actual move command 



NOTE: When doing so, the programmer must index 
the B-Address with the index register specified by 
the ^^STKINDEX" entry. 



What This Format of the Macro Will Do 



This format of the MVRSA macro-instruction will 
cause the 1301 IOCS to: 



(1) 



select an available segment of the Trans- 
action Stacking Area specified by the DIOCS 
^^STKAREA^^ entry; 



(2) cause the program to enter a waiting loop 

if no segment of the Transaction Stacking 

Area is available at the time of the request; 
and 

(3) insert the address of the selected section of 
the Transaction Stacking Area into the index 
ing register specified by the DIOCS 
^'STKINDEX" entry. 

Thus, the programmer is free to move the 
desired data into the Transaction Stacking Area by 



ands 



fied indexing register. 



ENTDR (Enter Disk Routine) 



The ENTDR macro-instruction must be the first 
instruction used in any Disk Routine of a prograi 



using the 1301 IOCS . 

This macro-instruction develops the coding 
required to store the return address of the main 
routine. This is the address to which control will 
be branched by the 1301 IOCS to continue process- 
ing of the main routine. See Figure 22. 

Tlie ENTDR macro-instruction does not have an 
operand and is written as indicated in Figure 23. 
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Figure 23. 




Develop 

Disk Address 



Branch 
Control 
to A or B 





GET 



Initiate i Complete 



SEEK 



READ 




B 



Figure 22. Use of the ENTDR Macro-Instruction 



What This Macro Will Do 



The coding provided by the ENTDR macro-instruc- 
tion stores the return address of the main routine. 
This permits resumption of processing in the main 
routine as soon as the next disk operation has been 
initiated. 



GET 



The programmer may use the GET macro-instruc- 
tion to mal^e a disk record available for processing. 
The two formats of the GET macro-instruction are 

described below. 



Format A 



This format of the GET macro-instruction is written 
as indicated in Figure 24. 



Line 
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Figure 24. 



The operand in Figure 24 is the name of the die 
file from which records are to be obtained. The 
name must be that used to describe the file in the 
DTF header line. 



What This Macro Will Do 



The functions of this macro-instruction depend on 
whether it is used for random or sequential process- 
ing. 
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RANDOM PROCESSING. Before using this macro- 
instruction for random processing, the programmer 
must store the appropriate address in the eight-char- 
acter field labeled lOCSDSKAD, as shown in Figure 2E 



Channel 



(cb or * 



Number 
of Disk 
Unit 



Track or Record Address 



lOCSDSKAD 




Figure 25, 



examole is shown 



Figure 



Un.^ 



Label 



0^ 




0.3 



J L I 1 L 



Operation 
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Figure 26- 



ngl 



cessing, 



lOCSDSKAD 



gnation and 



as indicated. The remainder of lOCSDSKAD is either 
HAl and HA2, the track address, or the six-character 

record address of the desired record. 

If the single -record mode is used in a random pro- 
cessing application, the user must place the four- 



lOCSSEKAD 



(This field is located within the IOCS and is the four- 
character field immediately to the left of lOCSDSKAD.) 

If the disk address is a track address, lOCSDSKAD 
must contain the four -digit HAl followed by the two- 
digit HA2. In full-track operations, there is no re- 
cord address and the field lOCSSEKAD is not used. 
Each time the programmer uses the GET macro- 
instruction in full-track mode, the 1301 IOCS will 
develop the coding required to: 



(1) 



check whether another disk operation is using 
the disk track specified by the disk address in 



(2) 



lOCSDSKAD 

the program 



another 



disk operation; 



(3) assign a disk arm to read the information; 

(4) assign the segment of the Disk Record Hold- 
ing Area into which the disk record is to be 

read; 

(5) seek the track specified by the disk address; 



(6) 



(7) 



read the disk record into the assigned seg 

ment of the Disk Record Holding Area; 

check whether another disk record is read 

for processing in the Disk Record Holding 

Area; 



(8) branch control to the disk routine if another 

disk record is waiting to be processed; 

(9) check whether a segment of the Transaction 

Stacking Area is available; 

(10) branch control to the main routine if a Stack- 

ing-Area segment is available; 

(11) check for disk read errors; 

(12) correct correctable read errors*, and 

release the segment of the Disk Record Hold- 
ing Area used by a GET immediately preced- 
ing the present GET macro-instruction. (See 

section describing the FSEQP macro-instruc- 
tion. ) 



(13) 



* On DATA CHECK indications, eight additional attempts to 

execute the command are made before an error message is 
printed on the console printer. 



SEQUENTIAL PROCESSING. Format A of the GET 
macro-instruction causes the 1301 IOCS to develop 

the coding required to: 

(1) make the next logical record available for 

processing; 

(2) take the next logical record from the next 
track, if a block of records has been 
exhausted; 

(3) check for read errors; 

(4) correct correctable read errors*; 



(5) 



Counter 



records of the current track have been 

exhausted; 



(6) check whether the address contained in the 

Track Counter is a valid disk address for 

the system defined by the DIOCS entries for 

this program , and 

(7) branch the program to the location specified 

in the DTF "EOFADDR" entry if the track 

address exceeds the address specified in the 

DTF "FILEND" entry. 

The area into which records are placed by this 
format of the GET macro-instruction depends on 
record type and the number of input/output areas , 

as follows: 

1. For blocked files using only one input/output 

area and for all files using two input/output 

areas: 

a. If indexing is used , this macro-instruction 
leaves the logical record in the input area 
and places the address of the record's 
high-order position into the specified index 
register. 

b. If indexing is not used , this macro -instruc- 
tion places the next logical record into the 
work area specified by the DTF 
"WORKAREA" entry. 
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2, For unblocked files using only one input/out- 
put area: 

This macro-instruction leaves the next logi- 
cal record in the input areas. 

Format B 



RETURNING UPDATED RECORDS TO DISK STOR- 
AGE. This type of PUT macro-instruction is used 

to return updated disk records to the locations in 

disk storage in which they were originally contained. 

It may be used for both random and sequential proc- 
essing and is written as indicated in Figure 28. 



This format of the GET macro-instruction is used 
only for sequential processing and is written as in- 
dicated in Figure 27. 
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Figure 2Z. 

The first entry in the operand of Figure 27 is the 

name of the disk file from which records are to be 

obtained. The name must be that used to describe 

the file in the DTF header line. The second entry 



name 



the record is to be moved. This format of the GET 

macro-instruction may be used for all record for- 
mats except unblocked records that use only one 

input area. 



PUT 
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Figure 28. 



The operand in Figure 28 is the name of* the disk 
file from which information was tal^en for updating. 
The name must be that used to describe the file in 
the DTF header line. 



What This Macro Will Do 



This type of PUT macro-instruction will develop 
the coding required to return a record (which contains 



information) 



nam 



macro-instruction. 



NOTE: When using this type of PUT macro-in- 
struction, the programmer must process the 
disk records in the Disk Record Holding Area. 



The programmer may use the various formats of the 

PUT macro-instruction to develop the coding re- 
quired to include processed or unprocessed records 

in a disk output file. 



What the PUT Macros Will Do 



LOADING RECORDS INTO SEQUENTIAL DISK- 
STORAGE LOCATIONS. This type of PUT macro- 
instruction has two formats. Both are used to load 

records into sequential disk-storage locations as 

described below. 



In addition to the functions listed xmder each format, 
all PUT macro-instructions will cause the 1301 

IOCS to develop the coding required to: 

(1) check that the disk arm required to write the 
information is available; 

(2) check for disk write errors; 

(3) correct correctable write errors*, and 

(4) release the segment of the Disk Record Holding 

Area that contained the information placed 

into disk storage. 
For the purpose of discussion, PUT macro-in- 
structions will be divided into three types: that 
used to return updated records to disk storage, that 
used to load information into sequential locations in 
disk storage, and that used to load information into 

non-sequential locations in disk storage. 



* On DATA CHECK indications, eight additional attempts to 
execute the command are made before an error message is 

printed on the console printer. 



Format A 



This format is written as indicated in Figure 29. 
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Figure 29. 



The first entry in the operand field in Figure 29 

is the name of a work area defined by a DA state- 
ment. The name of the file must be that used to 
describe the file in the DTF header line. 



What This Format of the Macro Will Do 



This macro-instruction will develop the coding re- 
quired to write successive logical records from a 

work area into sequential locations in disk storage. 
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Format B 



What this Macro Will Do 



This format may be used to load records contained 



m 



and is written as indicated in Figure 



This PUT macro-instruction will develop the coding 

required to load records contained in the Disk 

Record Holding Area into specified locations in 

disk storage. 




Figure 30. 



The first entry in the operand in Figure 30 is the 

name of the tape file from which records are to be 

talcen. The last entry in the operand is the name of 
the disk file into which the tape records are to be 
loaded. The names of both files must be those used 
to define the files in their respective DTF header 
lines. 



NOTE 1: This type of PUT macro-instruction 

cannot be used to return updated disk records 

to disk storage. 
NOTE 2: This macro-instruction causes the re- 
placement of the entire contents of a disk 
track, depending on the record format used. 
The programmer is cautioned against inad- 
vertently destroying disk data when using this 

macro-instruction. 



FSEQP (Force Sequential Processing) 



What This Format of the Macro Will Do 



This macro-instruction will develop the coding re- 
quired to write successive records from the speci- 
fied tape file into the specified disk file. The tape rec- 
ords are placed into the Disk Record Holding Area. 



LOADING RECORDS INTO NON -SEQUENTIAL DISK- 
STORAGE LOCATIONS. This type of PUT macro- 
instruction may be used to load records into nonse- 
quential locations in disk storage. (An example of 
this kind of application is the loading of new part 
records into an existing inventory file.) Before 
using this type of PUT macro-instruction, the pro- 
grammer must: 

(1) place the address of the disk location (into 



which the information 



into the 



lOCSDSKAD, and 



(2) 



place the information to be written into disk 

storage into a segment of the Disk Record 

Holding Area (which is addressed by the in- 
dexing register that was specified by the DI 

'^INDEXREG" entry of the file). 

s type of PUT macro-instruction is written i 

ted in Figure 31. 
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Figure 31 



The operand in Figure 31 is the name of the disk 
file into which records are to be loaded. The name 

must be that used to describe the file in the DTF 
header line. 



The programmer may use the FSEQP macro-instruc- 
tion to insure that disk records obtained by the disk 

routine(s) will be processed and returned to disk 
storage in the same order in which the correspond- 
ing transaction records were obtained by the main 

routine. See Figure 32. 

Such synchronization of the disk routine(s) with 
the main routine is important whenever reports are 
written by the disk routine (s). 

For example: Assume that Module 1 receives a 
request for information with an access time of 100 

ms, and that 10 ms later Module 2 receives a re- 
quest with access time of 50 ms. In this case, the 

arm of Module 2 will obtain the specified informa- 
tion before the arm of Module 1. 

If the Disk Routine does not use the FSEQP macro- 

instruction, the information obtained by the arm of 

Module 2 will be processed and the result returned 

to disk storage before the information sought by the 

arm of Module 1 can be read. In this case, the up- 
dated information will not be returned to disk stor- 
age in the order in which the corresponding trans- 
action records were read by the main routine. 

If the Disk Routine uses the FSEQP macro- 
instruction, the information obtained by the arm of 
Module 2 will not be processed imtil the information 

obtained by the arm of Module 1 has been processed 



and written back into disk storage. 



Figu 



no operand and 

It may be used 



anywhere in the progriam. 



What This Macro Will Do 



Each time the programmer inserts a FSEQP macro- 
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Figure 32. Use of the FSEQP Macro-Instruction 
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instruction in his program, the 1301 IOCS will de- 
velop the coding required to: 

(1) halt the processing of all transaction data until 
all data from previous transactions have been 
processed; 

(2) check whether another disk record is ready 

for processing in the Disk Record Holding Area; 

(3) branch control to the disk routine if another 
disk record is waiting to be processed; 

(4) check whether a segment of the Transaction 

Stacking Area is available; 

(5) branch control to the main routine if a Stack- 
ing Area segment is available, and 

(6) branch control to a waiting loop if neither a 
disk record nor a transaction record can be 
processed. See Figure 34. 

NOTE: If the FSEQP macro-instruction is given 
in the main routine, processing in the main 
routine will not continue until all disk-storage 
data has been processed. 



Additional Functions of the FSEQP Macro-Instruction 



le FSEQP macro-instruction has two important 
ditional functions. It can be used to prevent: 

(1) the release of a segment of the Disk Record 
Holding Area by the second of two successive 
GET macro-instructions, or 

(2) the release of a segment of the Disk Record 
Holding Area by an LEVDR macro-instruction. 

Both functions are described below. 
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Figure 34. Control Functions of the FSEQP Macro-Instruction 



RETENTION OF DISK DATA AFTER SECOND GET 

MACRO. Each time two disk GET macro-instruc- 
tions follow one another in a program, the second 
GET causes the release of the information obtained 
by the first GET macro-instruction. Thus, the cod- 
ing sequence: 

GET DISKFILEl 
GET DISKFILE2 
PROCESS 
PUT DISKFILE2 

will cause the release of the information obtained 

by the first GET; and only the information obtained 
by the second GET can be moved to PUT. The 
FSEQP macro-instruction may be used to prevent 

the release of the information obtained by the first 
GET macro-instruction, as indicated by the follow- 
ing coding sequence: 

GET DISKFILEl 

FSEQP 

GET DISKFILE2 

PROCESS 

PUT DISKFILE2 

PUT DISKFILEl 
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In this case, the FSEQP macro-instruction pre- 
vents the release of the information obtained by the 
first GET. 

NOTE 1: The order of the PUTs takes place as 
indicated. In general, arms that have ob- 
tained information from disk storage remain 
in position until the updated information is re- 
turned to storage. This eliminates SEEK 
time for PUTs, since the disk arm is already 



DISK ROUTINE 



in position. 



NOTE 2: 



cannot 



be used to hold information obtained by the 
first of two GETS involving the same file. 
Thus, in the coding sequence: 

GET DISKFILEl 

FSEQP 

GET DISKFILEl 

PROCESS 

the FSEQP macro -instruction cannot prevent 



information 



first GET. 



( 



RETENTION OF DISK DATA AFTER THE 'LEVDR' 
MACRO. The LEVDR macro-instruction, too, re- 
leases the information obtained by the last GET, as 
described in the discussion of the LEVDR macro- 
instruction. Thus, the coding sequence: 

GET DISKFILEl 



PROCESS 
LEVDR 



information 



by the GET macro-instruction. 

The FSEQP macro-instruction may be used to pre- 
vent the release of disk-record information by the 
LEVDR macro -instruction. Thus, in the coding 



sequence: 

GET DISKFILEl 

FSEQP 
LEVDR 

the information obtained by the GET will be re- 
tained in the Disk Record Holding Area for process- 
ing by a subsequent disk routine. 

NOTE 1: A FSEQP macro-instruction can cause 
erasure of information in the Disk Record 
Holding Area followed by rereading of the 
disk record. For this reason, the contents 

of a segment of the Disk Record Holding Area 

must not be changed between the GET and the 
FSEQP macro-instructions. Thus, the coding 



sequence: 



GET DISKFILEl 
UPDATE 



(■ 



FSEQP 

might result in the retention of the non-proc- 
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Figure 35. Use of the LEVDR Macro-Instruction 
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Figure 36. 



essed information contained in the Disk Record 

Holding Area. 
NOTE 2: The FSEQP macro -instruction may fol- 
low only those GET macro-instructions that 
refer to disk storage data. 



LEVDR (Leave Disk Routine) 



Each time processing of a set of transaction data 

has been completed by the disk routine, the work 

areas used by the data must be released and control 
must be returned to the main routine. The LEVDR 
macro-instruction, when used by the programmer 
as the last instruction in a disk routine, will cause 
the 1301 IOCS to develop all the coding required to 



handle these functions. 



Figure 



The LEVDR macro-instruction does not have an 
operand and is written as indicated in Figure 36. 



What This Macro Will Do 



Each time the programmer uses the LEVDR macro- 
instruction, the 1301 IOCS will develop the coding 

required to: 

(1) check whether the segment of the Transaction 
Stacking Area is required by another disk 
routine ; 
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(2) free the segment of the Transaction Stacking 
Area used by a completely processed trans- 
action ; 

(3) check whether another disk record is ready 

for processing in the Disk Record Holding 

Area; 

(4) branch control to the Disk Routine if another 

disk record is waiting to be processed; 

(5) check whether a segment of the Transaction 

Stacking Area is available; 

(6) branch control to the main routine if a Stack- 
ing Area segment is available, and 

(7) release the segment of the Disk Record Hold- 
ing Area used by a GET immediately pre- 
ceding the present LEVDR macro-instruction. 
(See the section describing the FSEQP macro- 



instruction.) 



GETS 



The programmer may use the GETS macro-instruc- 
tion to perform any of the following 1301 disk 

operations: 

L Seek a specified disk cylinder; 

2. Seek and Read a single disk record; 

3. Seek and Read a fvill track with or without 

addresses, and 

4. Seek and Read a full cylinder (optional 

feature) . 

When a 'GETS' macro-instruction is used within a 

Disk Routine, single-reference logic takes preced- 
ence over random logic. Therefore, no return to the 

main-line routine takes place as in the random pro- 
cessing use of the 'GET' macro-instruction. Any 
fields that are constructed or referenced in the user's 
program prior to the 'GETS' macro-instruction re- 
main unchanged and may be used after resumption of 
the user's program. 

NOTE: The GETS macro-instruction thus can be 

used to perform the operations identified by 

the mnemonic operation codes SD, RD, RHA, 
RFT. RDT andRCY. 



(4) set a switch to indicate that the disk READ 

operation has been completed. 

Additional functions of the GETS macro-instruc- 
tion are described below. 



HOLDING AREA CONTROL FIELD. Before using 

the GETS macro -instruction, the programmer must 

furnish the 1301 IOCS with information describing 

the precise nature of the operation to be performed. 

The programmer must enter this information in a 

30-character area known as the "Holding Area Con- 
trol Field," or, simply, "Control Field." The pro- 
grammer must reserve this control field in core 
storage by means of a DA entry, as indicated in 
Figure 37. 




Figure 37 . 

The control field must immediately precede the 



input area to be used. 



Figure 



The following information must be placed into the 
Holding Area Control Field before the GETS macro- 
instruction is encountered bv the oroffram: 



AREANAME (Positions 1-5). This field is re- 
served for the 1301 IOCS. 



What This Macro Will Do 



Each time the programmer uses a GETS macro- 
instruction, the 1301 IOCS will develop the coding 

required to: 

(1) check whether the disk arm required to per- 
form the operation is available ; 

(2) "stack" the request for the required disk arm 
if that arm is not available; 

(3) issue a Seek Disk command to position the 

access arm on the cylinder containing the re- 

auired information: 



CODE (Position 6) . This field contains one BCD 

character whose bit configuration is determined 

as follows: 

B = ON if wrong-length-record checking is to be 

performed by the 1301 IOCS; otherwise OFF 
A= OFF 



8 

4 



2 



OFF 

ON if Write Disk Check operation is to be 

performed; otherwise OFF, 

ON if only a SEEK operation is to be per- 
formed; otherwise OFF. Modification of 

SEEK only operations while the SEEK is in 
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High Order Position of Holding Area Control Record 



Figure 38. The Holding Area Control Record 

progress is described in the section "Addi- 
tional Inforination for Programmers. " 

1 = OFF 
The BCD characters formed by these various bit 

configurations are listed in Figure 91. See section, 

"Additional Information for Programmers. " 
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ter used as the Read-Operation-Complete Switch 
(see description of Formats C and D of the GETS 

macro -instruction) . 



NOTE: This field is left blank if Format A or B 

of the GETS macro-instruction is used. 



None (Position 7). Reserved for use by IOCS. 



HAl (Positions 8-11). Contains Home Address 1. 

NOTE: Needed only if single records are to be 

read or written. 



DISKINSTR 
language op 

formed. T 



Contains 



ABFn 



A = M if the operation is to be performed in 



Move 



L if the operation is to be performed in the 

Load mode. 

B = @ if the disk imit is attached to Channel 1; 

* if the disk imit is attached to Channel 2. 



F 



F 



n = 1 if a single record is to be read; 

2 if a full track without addresses is to be 

read; 

5 if a full track with home address is to be 

read; 

6 if a full track with addresses is to be 
read; 

@ if a full cylinder is to be read. 



DMODIFIER (Position 16). The d-character of the 

disk instruction. This is 

R 
unless a "to-end-of-core" read operation is to be 

performed, in which case the entry is 



DISKARM (Position 22). The digit ^^9'^ must be 
placed into this field before the program encounters 
the first GETS macro-instruction. The ^^9" can be 

assembled in this field as a constant. 

NOTE: The contents of this field must not be 

changed by the programmer. 



DISKADR 



This field must con- 



tain the B-field of the disk instruction to be per- 
formed. 



None (Position 30). This field must contain a group 

mark with word mark. 

Position 31. This is the first location of the input 

area into which the disk information is to be read. 

NOTE 1: The programmer may use any labels 

he wishes , but he must insure that they are 

unique if more than one control field is de- 
fined. 
The four formats of the GETS macro-instruction 
are described below. 



Format A 



This format of the GETS macro-instruction has no 

operand and is written as indicated in Figure 39. 
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Figure 39. 



SWITCHADR 



Contains the 



charac 



NOTE: Before using this format of the GETS 
macro -instruction, the programmer must place 
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the high-order address of the Holding Area 

Control Record (see Figure 38) Into Index 

Register 14. 



What This Format of the GETS Macro Will 



In addition to the fxmctions listed at the beginning o 

this section, this format of the GETS macro-instri 

tion will cause the 1301 IOCS to develop the coding 
required to: 



(1) branch control to a waiting loop while the 

disk seek operation is in progress; 

(2) interrupt waiting loop upon completion of the 

seek operation: 

(3) initiate the specified disk read operation; 

(4) branch control to a waiting loop while the 



(5) 



disk read operation is in progress; 

interrupt waiting loop upon completion of the 
disk read operation: 



(6) 

(7) 



check for disk read errors, and 
correct correctable disk read errors, * 



As indicated in Figure 40, the 1301 IOCS causes 

the program to enter a waiting loop until the disk 

record defined by the contents of the Holding Area 

Control Record has been read into core storage. 

Program execution, therefore, proceeds as fol- 
lows: Upon encoimtering a GETS macro-instruction, 

the program initiates the SEEK and then immediately 

branches control to the Operation-Complete Test. 

(See Figure 40.) When the SEEK is completed, an 

* On DATA CHECK indications, eight additional attempts to 
execute the command are made before an error message is 
printed on the console printer. 
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Figure 40. The GETS Macro-Instruction 
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iocs-provided interrupt causes processing to 

initiate the READ operation. The program then again 



Format C 



branches control to the Operation-Complete Test, and This format of the GETS macro-instruction is writ- 



program execution does not continue until this test 
indicates that the READ operation has been com- 
pleted. Processing then continues. 

Operation- Complete Switch - The test for comple- 
tion of seek and read operations is made by the 1301 
IOCS as follows: 

When the program encotmters a GETS macro - 

instruction, the IOCS sets a word mark in the core- 
storage position designated by the contents of the 

location labeled SWITCHADR. See Figure 38. 

The IOCS indicates completion of the SEEK and 
READ operations by clearing this word mark. The 
program, consequently, enters a waiting loop until 

the SEEK and READ operations are completed (i.e. , 

until the word mark is cleared) , whereupon the IOCS 

causes program execution to continue. 



ten as indicated in Figure 42. The operand is 



! 



^SWITCH". 
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Figure 42, 



NOTE: Before using this format of the GETS 

macro -instruction, the programmer must 

place the high-order address of the Holding 

Area Control Record into Index Register 14. 



What This Format of the GETS Macro Will Do 



Format B 



Format B of the GETS macro-instruction is written 

as indicated in Figure 41. 
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Figure 41. 



The operand is the label of the high-order posi- 
tion of the Holding Area Control Record. 



What This Format of the GETS Macro Will Do 



This format of the GETS macro-instruction performs 
the same functions (and develops the same coding) 
described above for Format A. However, when 
using Format B of the GETS macro-instruction, the 
programmer need not place the high-order address 
of the Holding Area Control Record into Index 
Register 14 prior to issuing the GETS macro-in- 
struction. 

NOTE: The functions provided by Formats A and 

B of the GETS macro -instruction correspond to 
Method 1 described in the section on "Single- 
Reference Processing/' 



In addition to the functions listed at the beginning of 

this section, this format of the GETS macro-instruc- 
tion will cause the 1301 IOCS to develop the coding 

required to: 

(1) branch control to the main routine to con- 



(2) 



(3) 



tinue processing while the disk seek opera- 
tion is in progress; 

interrupt processing upon completion of the 
seek operation; 
initiate the specified disk read operation; 



(4) branch control to the main routine to continue 



(5) 



(6) 

(7) 



processing while the disk read operation is 

in progress; 

interrupt processing upon completion of the 
disk read operation; 

check for disk read errors, and 

correct correctable disk read errors. * 



Operation 



In 



and 



programmer may place the Operation-Complete 

Switch anywhere in his program . 



NOTE: 



means that the programmer can 



Method 2 described in tl 

Reference Processing. " 



Figures 10 and 43 



* On Data Check indications, eight additional attempts to 
execute the comniand are made before an error message 

is printed on the console printer. 
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As indicated in Figure 43 , the test for completion 
of the disk SEEK and READ operations is made just 
prior to the time the disk information is needed by 

the program. 
This permits overlapping of the SEEK and READ 

operations with processing imtil such time as the 

disk record is needed for further processing. At 
this point, the program enters a waiting loop, and 
processing halts until the disk record has been 

obtained . 

NOTE: The 1301 IOCS will set and clear a word- 
mark switch, in the naanner described vmder 



Format A of the GETS macro-instruction, to 

indicate completion of SEEK and READ opera- 
tions. The location of this word-mark switch 

is defined by the programmer, who must place 

the address of the core -storage location of the 

desired word-mark switch into the SWITCHADR 

entry of the Holding Area Control Record. This 



must be done before the program encounters 
the GETS macro-instruction. The programmer 

must provide the coding required to test the 

(word-mark) switch unless he uses the WAITS 

macro -instruction. 
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Figure 43. The GETS, SWITCH Macro -Instruction 
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Format D 



What This Macro Will Do 



This format of the GETS mac 

ten as indicated in Figure 44. 
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Figure 44 - 



The first operand shown in Figure 44 is the label 
of the high-order position of the Holding Area Con- 
trol Record. The second operand is "SWITCH". 



NOTE: The operands may be listed in any order. 



What This Format of the Macro Will Do 



This format of the GETS macro-instruction per- 
forms the same functions (and develops the same 

coding) described above for Format C. However, 

when using Format D of the GETS macro-instruc- 
tion, the programmer need not place the high-orde 
address of the Holding Area Control Record into 
Index Register 14 prior to issuing the GETS macro 

instruction . 



PUTS 



The programmer may use the PUTS macro-instruc- 
tion to perform any of the following 1301 disk opera- 
tions: 

1. Seek a specified disk cylinder; 



2. 
3. 



and 
and 



4. Seek and write a full cylinder (optional featur^ , 

and 

5. Write a format track. 

When a 'PUTS* macro-instruction is used within a 

Disk Routine, single-reference logic takes preced- 
ence over random logic. Therefore, no return to 

the main-line routine takes place as in the random 

processing use of the 'PUT' macro-instruction. 

Any fields that are constructed or referenced in the 

user's program prior to the 'GETS' macro-instruc- 
tion remain unchanged and may be used after the re- 
sumption of the user's program. 



NOTE: The PUTS macro-instruction thus can be 

used to perform any of the operations identi- 
fied by the mnemonic operation codes SD, 

WD, WHA, WCY and WFO. 



Each time the programmer uses a PUTS macro- 
instruction, the 1301 IOCS will develop the coding 

required to: 

(1) check whether a disk arm required to perform 

the operation is available; 

(2) "stack" the request for the required disk arm 



that 



(3) 



available ; 

command 



infor 



mation is to be written, and 



(4) 



WRITE 



operation has be 

Additional functions 

are described below. 



instruction 



grammer 



describing the precise nature of the operation to be 
performed. He does this by means of the same Hold- 
ing Area Control Field described in the section on 



instruction 



The Holding Area Control Field is reserved in tl 
same manner and contains the same information as 

the corresponding area described in the section on 
the "GETS" macro-instruction, except as follows: 



DISKINSTR (Positions 12-15). This may contain the 

following (see description of the Holding Area Con- 
trol Record): 

1 if a single record is to be written; 

2 if a full track without addresses is to be 

written; 

5 if a full track with home addresses is to be 

written; 

6 if a full track with addresses is to be written; 

7 if a format track is to be written, and 

@ if a full cylinder is to be written. 



DMODIFIER (Position 16) 



This contains the d- 



character of the disk instruction. This is 

W 

vinless a "to-end-of-core" write operation 

performed, in which case the entry is 



X 



SWITCHADR 



This contains the 



address of the core-storage location of the charac- 
ter used as the Operation-Complete Switch (see 



and 



instructions) . 



NOTE: This field is left blank if Format A or B 
of the PUTS macro-instruction is used. 



The Eleven 1301 IOCS Macro-Instructions 



35 



DISKARM (Position 22). The digit "9" must be 

placed into this field before the program encounters 

the PUTS macro-instruction. 



Format A 



This format of the PUTS macro-instruction has no 
operand and is written as indicated in Figure 45. 



NOTE: The contents of this field must not be 
changed at any other time. 




Lab«l 



ou 




lN.ilAA£L 



I— ii 



Operotion 

PATS 



^ ^ * ^ ■ ' ' ' ' 



* ^ ' ^ 



2& 



^ 



J&. 



j__i — I — I — I — J — k 



■ 1 



1 t 1 1 L— J ■ ■ ' ' ' 
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Figure 45 . 



ANYLABEL (Position 31). This is the first location 
of the output area from which information is to be 

written into disk storage. 

The four formats of the PUTS macro-instruction 

r 

are described below. 



PUTS 



Were 
8 Attempts 

Made at Error. 
Correction 




Write Error Message) 



NOTE: Before using this format of the PUTS 

macro -instruction, the programmer must 

place the high-order address of the Holding 

Area Control Record (see Figure 38) into In- 
dex Register 14. 



n 




Figure 46. The PUTS Macro-Instruction 



1 



Continue 

Processing 
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What This Format of the Macro Will Do 



In addition to the functions listed at the beginning of 

this section, this format of the PUTS macro-instruc- 

tion will cause the 1301 IOCS to develop the coding 

required to: 

(1) branch control to a waiting loop while the disk 

seek operation is in progress; 

(2) interrupt waiting loop upon completion of the 

seek operation; 

(3) initiate the specified disk write operation; 

(4) branch control to a waiting loop while the disk 



(5) 



write operation is in progress; 
interrupt waitir^ loop upon con 

disk write operation; 



(6) 



and 



(7) correct correctable disk write errors, * 

As indicated in Figure 46, the 1301 IOCS causes 

the program to enter a waiting loop until the disk 

record defined by the contents of the Holding Area 

Control Record has been written into disk storage. 

Program execution, therefore, proceeds as fol- 
lows: Upon encoiontering the PUTS macro-instruc- 
tion, the program initiates the SEEK and then im- 
mediately branches control to the Operation-Com- 
plete Test. (See Figure 46. ) When the SEEK is 
completed, an interrupt causes IOCS to initiate the 

WRITE operation. The program then again branches 

control to the Operation-Complete Test, and program 

execution does not continue until this test indicates 

that the WRITE operation has been completed. 

cessing then continues. 



Pro- 



Qperation- Complete Switch. The test for completion 
of the SEEK and WRITE operations is the same as 
that described above for completion of read opera- 
tions . 

When the program encounters a PUTS macro - 
instruction, the IOCS sets a word mark in the core- 



branched 



and WRITE 



Figu 



and 



WRITE 



The 



program, consequently, enters a waiting loop until 

the SEEK and WRITE operations are completed (i.( 



until 



program 



Format B 



Format B of the PUTS macro-instruction is written 

as indicated in Figure 47. 



* On DATA CHECK indications, eight additional attempts to 

execute the command are made before an error message is 

printed on the console printer^ 




i& 



C^ /'fc ■iL.^./y.C"./- . . t . ■ ■ ■ ■ L 



■ 
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Figure 47 , 



The operand shown in Figure 47 is the label of the 

high-order position of the Holding Area Control 

Record. 



What This Format of the Macro Will Do 



This format of the PUTS macro-instruction performs 

the same functions (and develops the same coding) 

described above for Format A. However, when 
using Format B of the PUTS macro-instruction, the 
programmer need not place the high-order address 

of the Holding Area Control Record into Index Regis- 
ter 14 prior to issuing the PUTS macro-instruction. 

NOTE: The functions provided by Formats A and 

B of the PUTS macro -instruction correspond 
to Method 1 described in the section on '^Single- 
Reference Processing." 



Format C 



This format of the PUTS macro-instruction is writ- 
ten as indicated in Figure 48. The operand is 

"SWITCH". 



Lin« 



Label 



I 



ip«rati 



1 \AN.i.LA^xe.L. \P.UT 3. \3LJ.lJ.C.^, 




' i ■ I ■ 



' ' ' 



' * * ' 




1 



zs. 



ss. 




i 



' ■ ' ' * ' ■ * 1 1 A t.. A 



It*' « I I I 1 t 



J I I—I 




Figure 48 • 



NOTE: Before using this format of the PUTS 

macro-instruction, the programmer must 

place the high-order address of the Holding 

Area Control Record into Index Register 14. 



What This Format of the PUTS Will Do 



In addition to the functions listed at the beginning of 
this section, this format of the PUTS macro-in- 
struction will cause the 1301 IOCS to develop the 

coding required to: 

(1) branch control to the main routine to continue 

processing while the disk seek operation is in 

progress; 

(2) interrupt processing upon completion of the 

seek operation; 

(3) initiate the specified disk write operation; 

(4) branch control to the main routine to continue 

processing while the disk write operation is in 

progress; 
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(5) interrupt processing upon completion of the 

disk write operation; 

(6) check for disk write errors , and 

(7) correct correctable disk write errors. * 



ODeration-ComDlete Switch. In contrast with For- 




mats A and B of the PUTS macro -instruction, the 

programmer may place the Operation-Complete 

Switch anywhere in his program . 



* On DATA CHECK indications, eight additional attempts to 

execute the command are made before an error message is 
printed on the console printer. 



NOTE: This means that the programmer can use 
Method 2 described in the section on "Single- 
Reference Processing." See Figures 11 and 
49. 

As indicated in Figure 49, the test for completion 

of the disk SEEK and WRITE operations is made 

just prior to the time the updated disk record is 

replaced into disk storage. This permits overlapping 

of the SEEK and WRITE ooerations with orocessing. 



PUTS, SWITCH 



"Stack" Arm 

Request 






Initiate j Complete 



SEEK 



WRITE 





Continue 

Processing 
(Not Requiring 



Disk Data) 







Write Error Messag 







1 



Continue 
Processing 



Figure 49. THE PUTS, SWITCH Macro-Instruction 
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The 1301 IOCS will set and 



in the manner described under 

tie PUTS macro -instruction, tc 

1 At inn of the SEEK and WRITE 



operations . The 



programmer 



place the address of the core-storage location 

of the desired word-mark switch into the 
SWITCHADR entry of the Holding Area Contro 

Record. This must be done before the 

encovinters the PUTS macro -instructic 



program 

1. The 



oding 

unles 



WAITS 



WAITS ("Wait Single- Reference") 



The programmer may use the WAITS macro -instruc 
tion to develop the coding required to test the word- 
mark switch that is set and cleared by the IOCS to 
indicate the completion of disk input/output opera- 
tions. See the description of Formats C and D of 



and 



The WAITS 

in Figure 51. 



iperand 



SWrrCHTAG' in Figure 51) can 



signed by the user, but must not be defined by the 
user in his source program . The label will be gen- 
erated by the macro-instruction . 



Format D 



This format of the PUTS macro-instruction 
ten as indicated in Figure 50. 
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Figure 50 
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Figure 51 



operand in Figure 



high-or( 
Record. 



operand is "SWITCH 



NOTE: The operands may be listed in any order. 



What This Format of the Macro Will Do 



This format of the PUTS macro-instruction per- 
forms the same functions (and develops the same 

coding) described above for Format C. However, 

when using Format D of the PUTS macro-instruc- 
tion, the programmer need not place the high-ord 

address of the Holding Area Control Record into 

Index Register 14 prior to issuing the PUTS maci 
Instruction . 



What This Macro Will Do 



This macro-instruction will cause the program to 
enter a waiting loop until the input/output operation 
initiated by the preceding GETS or PUTS macro- 
instruction has been completed. When the operatic 
is complete , the loop will be interrupted , the word 
mark cleared, and control returned to the user at 

the point beyond this macro -instruction. 



"NOTE: 



programmer 



and 



WAITS macro -instruction (and generated by 

IOCS) in the Holding Area Control Record, in 

the field labeled 'SWITCHADR. ' (See Figure 38) 
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THE 'DIOCS' ENTRIES 



Purpose 



FEATURES 



Before the programmer can use the 1301 IOCS, he 

must supply the 1410 Autocoder processor with the 
information needed to determine which of the 1301 



program 



inform 



IBM 1401/1410 



Coding Sheet. These entries specify the sections 

of the 1301 Input^Output Control System to be in- 
cluded in the object program, and are known col- 
lectively as the DIOCS ("Define Input/Output Control 

System") entries. Each entry is described in detail 
below . 



General Format 



The first DIOCS entry is mandatory and consists of 
the mnemonic code DIOCS in the operation field. It 

is known as the "DIOCS header line. " This card 

must be the first card (except for special control 



during 



bly. 



NOTE: Only one DIOCS header card is permitted. 

It is normally supplied by the DIOCS header 

line written for Card/Tape IOCS. See Figure 
12. 
Each subsequent 1301 IOCS entry has a blank 

operation field and must have one of the labels listed 

below. * All DIOCS entry cards may contain com- 
ments. These must be separated from the DIOCS 

entry by at least two adjacent blanks. The DIOCS 

entries may be listed in any order and may be inter- 
mixed with the Card/Tape DIOCS cards. See Figure 
12. 



This DIOCS entry is mandatory. Its operands are 
OVERLAP, PRIORITY. See Figure 52. 



Line 



Label 



E 



I 
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I 
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Figure 52 • 
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CHANx 



This DIOCS entry is mandatory. It is used to indi- 
cate the channel to which the 1301 Disk Storage unit 



program 



The "x" in the 



CHANx 



1 if the 1301 Disk Storage unit is attached to 

Channel 1, and 

2 if the 1301 Disk Storage unit is attached to 

Channel 2, 
le operand of the CHANx entry is "1301". 

NOTE: If there is a 1301 Disk Storage unit 

attached to each channel , a CHANl and a 
CHAN2 entry must be made. 




Label 



B 




.ffi4.V.Ju I I I , 



*— » 1 1 1 l_J 1_L 



perati 



' i • • 
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12. 



Figure 53 • 
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Channel 



ntry in Figure 53 indicate 
unit used by the program 



List of DIOCS Entries 



This section describes the purpose of each of the 
following DIOCS entries: 



FEATURES 
CHANx 

PROCESTYPE 

RNDMDEPTH 

STKAREA 



STKINDEX 

SGMTLENGTH 

DISKARMS 

DISKOPTION 

NORCDEXIT 



Labels used in programs to be assembled by the 1410 Autocoder 
processor must not have more than 10 characters. 



PROCESTYPE 



This entry is not needed for single-reference process- 



ing 



entry 



program 



and/ 



operands 



are: 



RANDOM — if the program calls for random 
processing of disk files, and 

SEQUENTIAL --if the program calls for sequen- 
tial processing of disk files. 
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If both operands are used (i. e. , if the program 

calls for both random and sequential disk processing), 

the operands must be separated by a comma. They 

may be listed in any order. 



Line 
3 5 



I 



2 



Label 



15 



16 
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NOTE: For optimum arm schediding, it is sug- 
gested that the programmer specify the total 

number of available arms (not exceeding ten). 



Line 

3 5 



I 

- - -*-■-- 

2 



Label 



IS 



16 
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Figure 56 



Figure 54 



The operand in Figure 54 indicates that the pro- 
gram calls for random processing of one or more 

disk file(s). 



The operand in Figure 56 Indicates that up to three 
pending operations can be stacked at one time. 



STKAREA ("Stacking Area'*) 
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Figure 55. 

The operand in Figure 55 indicates that the pro- 
gram calls for both random and sequential disk 

processing operations. 



RNDMDEPTH ("Random Depth") 



This entry is required only for random files used 

for input operations. The operand of the STKAREA 

entry is the label of the DA (Define Area) statement 

that defines the Transaction Stacking Area. See 

Figures 57 and 58. 



The operand in Figure 58 indicates that the label 

of the DA statement that defines the Transaction 

Stacking Area of the program is labeled STACKAREA. 

See Figure 57. 



r 



This entry is required only for random files that are 

used for input operations. The operand indicates the 

maximum number of pending operations that are to 

be stacked. This number is the greater of two 

amounts: the number of arms used by a random file, 

or the number of random files serviced by a single 
arm. 



Line 
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Figure 58. 



15 



Operation 
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STKINDEX 




STACKAREA 




GMw. WM 



Contains the address 

of the segment from 
which or to which 
transaction data is to 
be transferred. The 
address is updated by 
the 1301 IOCS, 



Transaction Stacking Area 



Figure 57. The Transaction Stacking Area 



The DIOCS Entries 
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■» -^ 



STKINDEX ("Stacking Index") 



This entry is required only for random files used 
for input operations. 

The operand of the STKINDEX entry is: 

y where "y" is XI, X2, . • . , X12 and Identifies 

the index register assigned to the Transaction 

Stacking Area. This index register contains 

the address of the segment of the Transaction 

Stacking Area from which successive sets of 





Figure 61 . 



perand in Figure 61 indicates that 



gram 



DISKOPTION 



transaction data are to be taken. See Figures This entry is needed only 



4 and 6. 
NOTE: Index Registers 13-15 may not be used 

this purpose. 



Line 



1 



2 



Label 
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Figure 59 • 



The operand in Figure 59 indicates that Index 
Register 7 has been assigned to the Transaction 
Stacking Area of the program . 



SGMTLENGTH ("Segment Length") 



(1) if the program reads or writes single disk 



(2) 



records, or 

if the program calls for a 

disk check operations , or 



(3) 



unit 



the program 

computer. 



The entry is used to indicate whether the program 
calls for any of the above disk operations . 
The operands of the DISKOPTION entry are: 

SINGLERCD — if the program reads and/or writes 

single records. 



WRITECHECK — if the program calls for at least 

one Write Disk Check operation. 



This entry is required only for random files used 

for input operations. 

The operand of the SGMTLENGTH entry is: 

x where "x" is an integer indicating the number 

of positions of each segment of the Transaction 
Stacking Area. 

NOTE 1: If variable -length transaction records 

are to be moved to the Transaction Stacking 

Area, the segments must be large enough to 

hold the maximum-size record. 

NOTE 2: Each segment must contain a location 

for the Record Mark or Group Mark with 
Word Mark that terminates the move operation. 
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Figure 60 



The operand in Figure 60 indicates that each seg- 
ment of the Transaction Stacking Area has 81 posi- 
tions. See also Figure 57. 



DISKARMS 



The operand of the DISKARMS entry is the maximum 



modules 



program 



SHARED -- if the 1301 Disk Storage is shared by a 

7000-series computer. 

The operands may be listed in any order. 
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Figure 62. 



The operand in Figure 62 indicates 

gram is to write and/or read at least 

disk record. 



NOTE 1: If the SHARED operand is used, the IOCS 

will provide the coding required to enable the 

sharing system to have access to disk storage 

and to prevent interrupts from operations 

issued by the sharing system. 

At the completion of all disk operations and 
immediately prior to returning control to the 
main program, IOCS will execute a Prevent 
Seek Complete (PSC) operation to inhibit 
interrupts from the completion of seek opera- 
tions and a Release (REL) operation to permit 

the sharing system to have access to the 1301 
disk storage unit. 
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NOTE 2: 



ins true - 



command 



of the disk storage unit and retains it until 

the execution of a Release instruction. A 

PSC (Prevent Seek Complete ) instruction 

should be executed first by any program on 
a computer using a shared 1301; otherwise, 
interrupts caused by seeks issued by the 

sharing system will have to be serviced. 



NORCDEXIT 



This DIOCS entry is needed only if the program calls 
for the reading and/or writing of single records. 

This entry enables the programmer to have control 

branched to his own routine in the event of a No- 

Record-Found Condition. 

The use of the 'NORCDEXIT' entry will cause con- 
trol to be branched to the routine specified by the 

operand of the entry each time a No-Record-Found 

Condition is encountered. The first instruction in 

the user's No -Re cord -Found Routine must be a Store 

B -Register (SBR) that stores the return address to 

the IOCS. 

NOTE: Under no circumstances may the user's 

No-Record-Found Routine perform any I/O 

function, with or without the IOCS. In effect, 
the user's No-Record -Found Routine is oper- 
ating within the structure of the IOCS and 

any I/O operation will destroy the IOCS con- 
trol. 
Before branchii^ control to the user's routine, the 
1301 IOCS places into Index Register 14 the high- 
order address of the B-field of the disk instruction 

that led to the No-Record-Found Condition (see 



t 



DISK ADR 



I 



igure 



Upon completion of the 



user's No-Record-Found Routine, the IOCS checks 



has 



Record. If a change was made, the IOCS will 

flffftmnf. to locate the record in an alternate ad 

hv the user's No -Re cord -Found Roi 



ing 



When 



transaction may be ignored by the IOCS or retained 

by the IOCS for the user. Placing an S in the ad- 
dress portion (2+X14) of the 'DISK ADR' in the Holding 

Area Control Record while in the No -Re cord -Found 

Routine causes the IOCS to ignore the transaction 

and skip the remainder of the disk routine. In this 
case, the transaction is not retrievable. By plac- 
ing a ^ in the same position the transaction will be^ 
retained by the IOCS for the user. The use of the P 
allows the user to test for the P after the IOCS re- 
turns to GET +1 or PUT +1. For form 1, 2 or 3 

records, the ^ may be located by subtracting 7 from 

the index register associated with that file. Form 4 

records require that 11 be subtracted from this index 
register because of the block character-count field. 



Figure 75). 

transaction 



After 



then be processed as the user desires. This means 

of communicating with the IOCS (by using the ^ or S) 
is necessary because at the time the users no-record- 
found routine is being executed neither the address 

of the transaction that caused the no-record-found 

condition is known, nor may any I/O operation be 

performed to dispose of the transaction, even if the 

address were known. 



changed 



after 



channel 



disk, the IOCS will withdraw the access mechanism 

completely, reposition it at track number 0000, re- 
issue the SEEK command for the desired track and 
try again to execute the disk instruction. If the no- 
record-found Condition then recurs, the IOCS will 
enter a waiting loop and an appropriate message 

will be typed on the console printer. 



The DIOCS Entries 
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THE 'DTF' ENTRIES 



Purpose 



The following entries apply to both random and se- 
quential processing; 



In addition to the DIOCS entries , the programmer 

who wishes to use the 1301 Input/Output Control 
System must write one set of DTF (Define The File) 

entries for each disk file used by his program. This 

information consists of up to 14 entries listed indi- 
vidually on the IBM Autocoder 1401/1410 Coding 

Sheet. 

Each set of DTF entries describes the character- 
istics of the file for which it was written and indi- 
cates the methods to be used by the 1301 IOCS in 

handling the file. Using the information supplied in 

the DTF entries, the Autocoder processor develops 

the File Scheduler and the coding required for the 

proper handling of each file. 

NOTE: DTF entries are not required for single- 
reference processing because files need not be 

defined for this mode of processing. 



General Format 



DTF header line 

FILETYPE 

SIZEREC 

HOLDAREA 
INDEXREG 

FILE FORM 

BLOCKSIZE 
DISKCHECK 

WLRADDR 

The following entries apply only to sequential 

■ 

processing: 

RE C FORM 

SCRAMBLE 
NRE CORDS 
PADDING 
WORKAREA 

FILESTART 

FILEND 

EOFADDR 



The first DTF entry is the "DTF header line. " It 

consists of the mnemonic code "DTF" in the opera- 
tion field followed by the name of the file in the 

operand field. All subsequent DTF entries have 

blank operation fields and must have the labels listed 

below. All disk DTF entries may be followed by 

comments. These must be separated from the DTF 

entries by at least two adjacent blanks. The entries 

following the header line may be listed in any order. 

All operands of disk DTF entries may use address 
modification provided that the operand consists of 
no more than 13 characters. Thus, ^LABEL + 110' 
is a valid operand if LABEL consists of no more 
than nine characters. All symbolic operands of DTF 
entries, except those of input/output areas, may be 
indexed. (The number of characters used to desig- 
nate the index must be included in the count of 13.) 

The sets of Disk DTF cards may be intermixed 

with the sets of the Card/Tape DTF cards and enter 

the system immediately after the DIOCS cards dur- 
ing Autocoder assembly. See Figure 12. Each Disk 

DTF entry is described below under a subheading 

indicating the label of the entry. 
NOTE: DTF cards without operands are not 

permitted • 



List of DTF Entries 



This section describes the fxmction and use of each 
of the DTF entries listed below. 



THE 'DTF' HEADER LINE 



The first DTF entry is mandatory and consists of the 

mnemonic code DTF in the operation field, followed 

in the operand field by the name of the file defined 
by this DTF. 
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Figure 63, 

The operand in Figure 63 indicates that the set of 
DTF entries following this header line defines a 
file called PARTMASTER. 



FILETYPE 



entry 



cribed by this DTF is a disk file and specifies 

whether it is a random or a sequential file, and 

whether it is used for input or for output operations. 

The operands of the FILETYPE entry are: 



DISK — This entry is mandatory and indicates that 

the file described by the DTF is a disk file. (The 
DISK operand is needed because the "FILETYPE" 
DTF entry is also used by the Card/Tape IOCS. ) 



* Note that data from a disk input file may be returned to that file 

after updating. 
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INPUT ~ if the file described by the DTF is used 

for input operations. 



SIZEREC 



OUTPUT ~ if the file described by the DTF is used The SIZEREC entry is mandatory. Its operand de- 



only for output operations. 



pends on record size as follows: 



SEQUENTIAL — if the file described by the DTF is 

a sequential file. 
RANDOM — if the file described by the DTF is a 

random file. 
NOTE 1: The operands INPUT and RANDOM may 

be listed but are not required. 



The operands of the FILETYPE entry may be 
listed in any order and must be separated by commas 



Variable-Length Records (Sequential Files Only) 



The operand of the SIZEREC entry is: 

n where *'n" indicates that the low-order position 

of each record's character -count field is the 

"nth" character of each record. See the 

example below. 




OJ. 



Label 



B 



perati 



;j 



1 



jXi I I » i — • — » — I — 1. 




21 



1^ 



1£ 



1& 



*a 



OPERAND 
_4S 



ou.r.p^^:f'.^ gj-.^.x ..J. /-.<?.</.*- ^.r-././y,^. 



* 



I ' ^ * — 1—1 — i * * 



I 1 ' ' ' ^ ' 1 fc__i i i I i—L 



J l 



Figure 64 • 
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Figure 66 



The operands in Figure 64 indicate that the disk 

file described by this DTF is a sequential output file 



The entry in Figure 66 indicates that the low-ord 
position of the character-count field in each record 
of this disk file is the 10th position of the record. 
See also Figure 67. 



Line 

3 b 



T 



I 



2 



Label 



15 



16 



/^J/ , ^ . ^ . / l ^ . ^ . 



J ^ ' - ■ ' > ' 1 



perati 



;;] 




i i 



J 1 1 I 



2& 



M 



i. 



1& 



f A-.i^.6/.r.. .^j-,^./r. , 



' ' i L_J 1 1 1 1 1 



■ ■' ■■' ■ I I 1 1 1 1 1 1 1 1 » 




Figure 65 • 



The operands in Figure 65 indicate that the file 

described by this DTF is a random input file. 



Fixed- Length Records 



le operand of the SIZEREC entry is: 

m where "m" is the number of characters in the 

record, including the record mark. (Thus, 

the operand is "80" for eighty -character 

records.) See Figure 68. 
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Figure 68 



NOTE: 



In random processing and in single- 



reference mode, variable -length records are treat- 
ed by IOCS as fixed length records. (See DTF 

'RECFORM' entry 



HOLDAREA 



The operand of the HOLDAREA entry is the label of 
the DA (Define Area) statement that defines the Disk 

Record Holding Area assigned to the file. The loca- 
tion represented by this label is the high-order posi- 
tion of the Disk Record Holding Area. 



defined by the programmer in his DA entry for the 
first segment. 

The size of the Holding Area is determined as 
shown in Figure 86 and explained in the accompany- 
ing description. 

The DA statements required for a Holding Area 
which contains six segments for 120-character rec- 
ords are shown in figure 69A. 



Number of Segments 



The nximber of segments is determined as follows: 

Sequential Processing. Either one or two segments 

may be used. The total output per unit of time is 

usually greater if two Holding-Area segments are 

used. 
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Figure 69 



The operand in Figure 69 indicates that the label 
of the Disk Record Holding Area of the file is 
DISKAREA. (See Figures 14 and 86.) 

The holding area consists of n sets of two fields. 
The fields in each set consist of a 30-character 

Holding Area Control Field immediately followed by 

an input/output segment. (See the description of 
the GETS macro-instruction for a complete explana- 
tion of the Holding Area Control Field.) In both 

random and sequential processing applications, the 
user need only define the areas for these fields by 

means of DA statements. IOCS will place the nec- 
essary information in these fields as required. 

The length of a Holding-Area segment is speci- 
fied in the DTF 'BLOCKSIZE' entry, and depends on 
the record format and the mode in which the infor- 
mation is recorded. (See Figure 87.) If more than 

one segment is used, the IOCS will set up the word 

marks in all segments in the same manner as 



Random Processing. The number of segments de- 
pends on 

(1) the number of arms available to service a 

file , and 

(2) the number of transaction records which may 

be stacked and request disk records from the 
file. 

For optimum arm scheduling, the number of seg- 
ments should not be less than the number of arms 
available to the file. 



Size of Segments 



The size of each segment of the Disk Record Holding 
Area depends on the record format and the mode in 

which the information is to be read or written. See 

Figure 87. For a detailed description of the Disk 

Record Holding Area see Figure 86 and the descrip- 
tion of the DTF 'BLOCKSIZE' entry. 



INDEXREG 



entry 



gned 




Figure 69A, 
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described by the DTF. The entry is mandatory for 

all random disk files. 

The operand of the INDEXREG entry is: 

indicating the index register assigned to the file. 
NOTE 1: Index Reeisters 13, 14 and 15 may not 



gned 



NOTE 2: 

data 



programmer 



means 



INDEXREG" entry for that 



This index register will contain the address 

of the high-order position of the disk record. 
Therefore, if the programmer designates the 
index register specified by the DTF "INDEX- 
REG" entry in the DA entry for the Disk Rec- 
ord Holding Area , the fields in that area will 

be automatically addressed by the index 

register. 



FILE FORM 



This entry is mandatory. 

The operands of the FILEFORM 



MOVE ~ if the file described by the DTF is read 

or written in the MOVE mode; 

LOAD — if the file described by the DTF is read 

or written in the LOAD mode; 

SINGLE — if the file described by the DTF con- 
sists of single records. NOTE: if this operand 

is used, the SCRAMBLE entry must be given: 

CYLINDER ~ if the file described by the DTF is 

contained on an entire cylinder. (The cylinder 

optional feature must be attached.) 
TRACK — if the file described by the DTF con- 
sists of full -track records. 
NOADDRESS ~ if full tracks without record ad- 
dress are to be read or written. 



Move Mode vs. Load Mode 



On magnetic tape, word marks are represented by 

word separator characters in disk storage . Word 

marks are represented by actual bits. Hence, when- 
ever the programmer desires to place information 

into disk storage with word marks, each character 

in disk storage must be associated with an additional 

disk-storage bit for the word-mark bit. The char- 
acter storage -capacity of a given track of disk stor- 

^e, therefore, varies with the mode in which the 

information is read or written. 



"MOVE" MODE. When written in the MOVE mode 

(i.e. , word marks are not required), each character 



is represented by seven bits: six 



space bit. 



can 



MOVE 



LOAD 



When written in the LOAD 



(i.e. , word marks are required) each character is 

represented by nine bits; 



SIX 



two 



Each track can hold 



up to 2,165 characters written in the LOAD (or "8- 



bit") mode. 



Figures 70 and 



SCRAMBLE 



This entry is used only for sequential files , with 

single -reference processing. The user must save 

the B-address register to effect the return to IOCS. 

IOCS will take the SCRAMBLE exit whenever it needs 

a new record address. 

Before branching control to the user's routine 
specified in the operand of this macro-instruction, 

IOCS places into Index Register 14 the high-order 

position of the Holding Area Control Record (see 

Figure 38). The track address is located in the field 

labeled 'HAl. ' (See the DTF 'NRE CORDS' entry for 

a description of how sequential track addresses are 

updated . ) 

The record address developed by the routine must 

be placed in the B-field of the Holding Area Control 

Record. 



DISKCHECK 



Write 



operation is to be performed. The operand of this 

DTF entry is YES. 



RECFORM 



* 



This entry is needed only for sequential disk files 

containing other than fixed-length, unblocked records. 
The operands of the RECFORM are: 

VARIABLE — if the file described by the DTF con- 
sists of variable-length records, and 

BLOCKED ~ if the records described by the DTF 

are blocked. 

The operands must be separated by a comma and 

may be listed in any order. 



NOTE: The operands FIXED and UNBLOCKED, 

referring to fixed-length and unblocked rec- 
ords, respectively, may be used but are not 

required. 

A description of the record formats that can be 

handled bv the 1301 IOCS follows. 



* Random input files are treated as fixed-length, blocked files; 

random output files are treated as fixed-length, unblocked 

files. 
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7 bits each per BCD character 



Space 
Bit 





Figure 70, MOVE Mode: Seven Disk Bits per BCD Character, 2800 Characters per Track 
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Figure 71. LOAD Mode: Nine Disk Bits per BCD Ch 
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Figure 72. Disk Track with Form-l Records, with Record Marks 
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Figure 73. Disk Track with Form-l Records, without Record Marks 



Index 
Point 



HAl 



GAP 




Record 
HA2 Address 1 



Record 8 



Record 7 



Record 6 



Record 5 



Record 4 




GAP 




Record 3 



Record 2 



Record 1 



Record 
Address 2 



GAP 




Figure 74, Disk Track with Forni-2 Records 
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Figure 75. Disk Track with Form-4 Records 



Each block has a variable number of variable -length records 
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^Record marks are required only if the output files are to be blocked. 

^Record Character-count is contained in Record Character-count Field of each record. 



Figure 76. Summary of Record Formats for Sequential Processing Using 1301 IOCS 



t 



3 



Record 3 
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work 

Areas 



Needed only if 

2 I/O areas are 
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Record Formats That Can Be Handled by the 1301 



IOCS 



Form-1 Records. 



length, unblocked 



records ~ with or without Record Marks. See Fig- 



ures 72 and 73. 



Form -2 Records, 



length 



records ~ with Record Marks ~ with padding of 



length 



See Figure 74. 



NOTE 1: Fixed-length, blocked records that 



•nly 



character specified in the DTF "PADDING 



blanlcs 



omitted. 



NOTE 2: 



length 



imblocked records) will be handled 



* Blocked records must always have a record mark in the low-order 

position. Unblocked records may or may not contain record 

marks. However, unblocked records which are to be moved by 



WORKAREA 



"PUT RNDMOUTFIL" macro- 



instructions must have either a record mark or a group mark with 
word mark immediately to the right of the low-order position. 



IOCS as fixed-length 

track requirements. 



Form-4 Records. 



length 



blocked records, with Record Marks and Block 
Character-Count Field, and Record Character- 



Count Field in each record. 



NOTE: 



See Figure 75. 

ing and in singl 



reference operations, Form -2 and Form-4 
records (blocked records) are logically treated 
as unblocked records by IOCS. The disk re- 
cords are read or written as requested, but 
unblocking cannot be performed by IOCS. 



COUNT 



A four- 



Count 



ginning of each block contains a count of the total 
number of characters in the block including the 



Count 



Count 



units 



count 



conditions . 



and correcting wrong -length 
See Figure 76. 
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CHARACTER-COUNT 



A Record 



Character-Count 



coxmt of the number 



characters in that record, including itself and the 

record mark. 



NRE CORDS 



This entry is required for all sequential disk files 
from or onto which single records are read or writ- 
ten. 



characteristics of pen 

summarized in Figure 




Examples of RECFORM 

Figures 77 and 78. 
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Figure 77. 



operand in Figure 



contains Form -2 (i.e. • fixed 



length, blocked) Record 
could have been written 



same 
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Figure 78, 



The operand of the NRE CORDS entry is 

n where "n" is the number of records per track. 



NOTE 1: 



can be any 



1 to 99. For every 'n' requests for a record, 
the track address is stepped by one. The user 

is provided with the track address in HAl of 

the Holding Area Control Record when IOCS 
exits to the routine specified in the user's DTF 

'SCRAMBLE* entry. 



NOTE 2: 



type 



SCRAMBLE 
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Figure 80. 



The entry indicated in Figure 78 is equivalent to 

that shown in Figure 77 because the operand FIXED 
need not be written. 



The operand in Figure 80 indicates that each disk 

track of this file contains three records. 



PADDING 



BLOCKSIZE 



This entry is required. 



pecifi 



the number of positions occupied by each segment 

of the holding area reserved for an input or output 

disk record. 



NOTE: 



character 



terminating 



word mark are not included in this count. 

(These must be included in the DA entries 

for the Disk Record Holding Area. ) 
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Figure 79* 



entry 



fixed length 



The operand of the PADDING entry is: 
X where "x" is the character with which the 
block is to be padded. 



The following characyters may 

padding: asterisk, tape mark, word separator char- 
acter, record mark, cent sign and 
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Figure 81. 



entry in Figu 



that 



filled blocks are to be padded with the digit 9 



The entry in Figure 79 indicates that disk -record 
segments of the holding area for the file defined by 

this DTF are each 2800 characters in length. 



* If the PADDING entry is omitted, partially filled blocks of this 

record type will be padded with blanks. 
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Figure 82. Operand of the DTF "FILESTART" and "FILEND" entries 




WORKAREA 



This entry is needed only for sequential files that 
use a work area and do not use the DTF "INDEXREG" 

entry. 

The operand of the WORKAREA entry is the label 
of the work area used by the input or work file . 



FILESTART 



?his entry is needed only for 
iperand of the FILESTART e: 

xxxxxxxx where "xxxxxxxx 



The 



ing the first track of the (sequential) 



Figure 
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Figure 83. 



The operand in Figure 83 indicates that the first 

track of the file defined by this DTF is track 2415 
with HA2 of 80 in Disk Unit 1, which is attached to 
Channel 2 of the system. 



FILEND 



This entry is needed only for sequential files. The 

operand of the FILEND entry is: 

xxxxxxxx where "xxxxxxxx" are eight digits defin- 
ing the last track of the (sequential) 

file, as indicated in Figure 84. 




Figure 84, 



gure 



track of the file defined by this DTF is track 2549 

stored in Disk Unit 1, which is attached to Channel 

2 of the system. 



EOFADDR 



This entry is required for sequential files only. 

The operand of the EOFADDR entry is the label of 
the routine (written by the programmer) to which 
control is to be branched if the program develops an 
address exceeding that defined by the DTF "FILEND" 

entry . 



WLRADDR 



This DTF entry, when used for a disk file, elimi- 
nates the normal wrong-length record checking per 
formed by the IOCS for that disk file. It is useful 
if the programmer is expecting a wrong-length re- 
cord indication and wishes the IOCS to ignore it. 
The operand in the disk 'WLRADDR' DTF entry is 
'NO', to indicate that no checking is to be done. 



NOTE : 



WLRADDR 



for files assigned to disk storage is different 
from the use of this entry for any other type 
of device. 
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(DEFINE AREA) ENTRIES NEEDED 



All areas required by the 1301 IOCS (i. e. , Trans- 
action Stacking Areas, Disk Record Holding Areas, 

and Holding Area Control Records) must be re- 
served by the programmer by means of appropriate 

DA entries. (A general discussion of how DAs are 

written may be found in the IBM Data Processing 

Systems bulletin, "Basic Autocoder for the IBM 1410 

Preliminary Specifications," Form J24-1413.) All 
such areas must be terminated by a group mark with 

word mark immediately to the right of the low-order 
position of the area. 

The following describes how DA entries are writ- 
ten for the Transaction Stacking Area for Disk Rec- 
ord Holding Areas. 



In Figure 85, 

N indicates the number of identical segments 

to be reserved; 

M indicates the number of positions to be 

reserved for each segment; 

G specifies that a group mark with word mark 

(needed by the 1301 IOCS) is to follow 

immediately to the right of the area reserved 

by this DA, and 
INSTACKX is the label (name) of the index 

register assigned to the Transac- 
tion Stacking Area. See the 1301 

IOCS "STKINDEX" entry, and 

Figure 39. 



DA ENTRY FOR THE TRANSACTION STACKING 
AREA 



Each 1410 program written for random processing 
that is to utilize the IBM IOCS requires one Trans- 
action Stacking Area. The Transaction Stacking 
Area permits the "stacking" of incoming transaction 

records for use by the disk routine (s). 



NOTE: 



Transaction 



Area assigned to a given transaction may also 

be used for storage during the processing of the 

transaction. Information so stored will be 

protected until the segment of the Transaction 

Stacking Area is released. Information stored 

by the disk routine in any other field in storage 

might be destroyed during the processing of 

another transaction record. See Figures 4 and 5. 



The DA entry for a Transaction Stacking Area is 



shown 




Figure 85 . 



NOTE 1: For applications requiring more than 
one disk routine, the number of segments N 
should be calculated by the following formula: 



N 




S 



, where: 



Op 



s 



Operand of the DIOCS "RNDMDEPTH" 

entry, and 

Number of SEEKS per transaction that can 
be executed simultaneously. 



NOTE 2: If variable-length transaction records 

are to be moved to the Transaction Stacking 

Area, each segment must be large enough to 

hold the maximum-size record. 

NOTE 3: Each segment must contain a location 

for the record mark or the group mark with 

word mark that terminates the move operation 



informa 



tion. 



NOTE 4: The word marks specified for Fields 1, 

2 and 3 are needed only if the programmer 

desires to move data to the Transaction 

Stacking Area by actual move commands. 

NOTE 5: The label of the DA statement is used to 

describe the area in the DIOCS "STKAREA" 
entry. 



52 



DA ENTRIES FOR DISK RECORD HOLDING AREAS 



Each program utilizing the IBM 1301 IOCS requires 

one Disk Record Holding Area for each disk file 

■ 

used by the program. The Disk Record Holding 

Areas are used for the storing and processing of 

information obtained from disk storage. Each Disk 

Record Holding Area must be reserved by the pro- 
grammer by an appropriate DA entry. 

The size of each Disk Record Holding Area (i. e. , 
the number of segments of the area and the size of 

each segment) depends on the record format and the 

type of application. The number of segments re- 



quired has been described in the discussion of the 
DTF "HOLDAREA^' entry. 

Figure 86 indicates the general format of a Disk 

Record Holding Area. As indicated in Figure 86, 

each segment of the Disk Record Holding Area must 

be preceded by a 30-position area required by the 1301 

IOCS. Each segment must be followed by a loca- 
tion for a group mark with word mark to be inserted 

by the 1301 IOCS. (See OPEN macro -instruct ion and 

Figure 14.) The entire Disk Record Holding Area 
must be followed by one location for a final group 

mark with word mark that must be specified by the 

programmer. 



DISKAREA 




3Q-Position Area Required by the 1301 IOCS 



1st Segment of the Disk Record Holding Area 



GM w. WM 



30-Position Area Required by the 1301 IOCS 



2nd Segment 



GM w. WM 



30-Position Area Required by the 1301 IOCS 



3rd Segment 





30-Position Area Required by the 1301 IOCS 



nth Segment 



GM w. WM 




Figure 86. Format of Disk Record Holding Area 



DA Entries Needed to Support 1301 IOCS 
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The size of each segment of the Disk Record Hold- 
ing Area depends on the record format and the mode 

in which the information is to be read or written. 

See Figure 87. 

Figure 88 shows an example of the type of DA 
entries that must be written for a sequential disk 
file containii^ three 65-character records per block 

that are read and written in the MOVE mode. See 

also section on "Move Mode vs. Load Mode. " 



NOTE 1: 



ark 



block and the word marks for the second and 
third blocks are provided by the OPEN macro- 



instruction. See description of the OPEN 
macro-instruction, including Figure 14. 
NOTE 2: All random files must be indexed (rela- 
tive to zero) with the indexing register specified 

by the DTF "INDEXREG" entry. 

NOTE 3: Information in sequential files may be 

either indexed or moved. See description of 

the GET macro-instructions. 



DA ENTRIES FOR HOLDING AREA CONTROL 
RECORDS 



See description of the GETS macro-instruction. 



Record Format and Mode 


Total number of positions 

which must be reserved 
by that programmer for 

each segment. 


Use of the Reserved Area 


w 


For 

Disk Data 


For Disk 

IOCS Control 

Information 


For 
CM w. WM 


Full TRACK, LOAD 


2195 


2165 


29 


1 


Full TRACK, MOVE 


2830 


2800 


29 


1 



Figure 87. SIZE and USE of the segments of Disk Record Holding Areas 
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ADDITIONAL INFORMATION FOR PROGRAMMERS 



THE SIZE OF THE 1301 IOCS ROUTINES 



USE OF INDEX REGISTERS 



The approximate number of storage locations re- 
quired by the 1301 IOCS Routines are as follows: 



Single Reference Routine: 

Random-Processing Routine: 



2,500 locations 

3,000 locations 



Sequential-Processing Routine: 1,000 locations 



Error Routines: 

See Figure 11. 



3,500 locations 



Index Registers X13-X15 are used by the 1301 IOCS, 

and their contents may change each time a macro- 

instruction is encountered. The programmer may 

use these index registers, but he should consider 

the effect of the above on his program. 
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CODING EXAMPLE 



The following coding example illustrates the incor- 
poration of the 1301 IOCS into a 1410 program. It 
illustrates a parts -inventory application. The 
inventory file is updated on the basis of transaction 
records showing receipts and disbursements. The 
program also calls for the writing of a report show- 
ing the warehouse location and retail price of each 

part listed under disbursenaents . See Figures 89 and 90 . 

This type of application has been described 

above under "Random Processing." 



MODIFICATION OF 'SEEK-ONLY' OPERATIONS 
WHILE SEEK IS IN PROGRESS 



The programmer can modify an initiated SEEK op- 
eration by taking three steps before the completion 

of the SEEK, He must: 

1. mask priority interrupts by means of the 

Branch to Exit Priority Alert (mnemonic op- 
eration code BXPA) instruction; 

2. check the specified switch for completion of 

the SEEK operation (See formats C and D of 

the GETS macro-instruction), and 



3. change bit position 2 from ON to OFF. (ON is 
indicated by the presence of a bit; OFF is 

, indicated by the absence of a bit. ) 

This will cause completion of the SEEK operation 

to be followed by the operation specified by the 

D-modifier. 

This technique enables the programmer to initiate 

the SEEK operation and while the SEEK is in prog- 
ress determine by processing whether the SEEK is 

to be followed by a READ or WRITE operation. 

In each case, the turning OFF of bit position 2 will in- 
volve a change of the character entered in CODE (position 
6) of the Holding Area Control Record. See Figure 91. 

Let it be assumed, for example, that the prog- 
rammer placed a W into DMODIFIER, and a K into 
CODE. In this case the presence of the 2 bit (BCD 

representation for K = B2) indicates that only a SEEK 
operation is to be performed. (See explanation of 

the CODE entry in the Holding Area Control Record.) 

If the programmer determines by processing 
(while the SEEK is in progress) that the SEEK op- 
eration should be followed by a disk READ opera- 
tion with wrong-length-record checking by IOCS, he 
need only change the contents of CODE from K to 

- (minus sign). The elimination of the 2-bit in 
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CODE now causes the SEEK to be followed by the 

operation specified by the contents of the DMODL 



READ 



length 



because of the presence of the B-bit. (The BCD 



minus sign 



GLOSSARY 



The following Glossary is restricted to basic terms 

used or introduced in this bulletin. 



IOCS LABELS THAT MAY BE USEFUL 



lOCSxxBFLD - A seven-position field containing tl 

module number and six -position disk address for i 

sequential track file. It may be altered to control 

changes in the "sequential" order. 



lOCSxxDKAD - A four-position field containing a 

track address for single-record files. 



lOCSxxINCR and lOCSxxCONS - These two 



insure accessing 



maximum 



of times after a change to 

lOCSxxINCR, lOCSxxCONS 



I 



lOCSxxDKAD 



t 



be given when accessing records from other than 



next 



sequential track. The maximum number of 
times data may be accessed from a track is equal to 
the number of data records on that track, as defined 
in the 'NRECORDS' DTF entry. 



t 



t 



An 



od 



lOCSxxSTRT 

the information 

'FILESTART' I 

fied at any time; however, the change will not be in 
effect until an 'OPEN' macro-instruction has been 

executed for that file. 



'lOCSxxEND' - An eight-position field that contains 

the information supplied to the IOCS by means of the 

user's 'FILEND' DTF entry. It may be modified at 

anytime; however, it must be greater than the cur- 
rent address as given in 'lOCSxxBFLD' or 

' IOC SxxDKAD ' . 

The 'PREFIX' macro-instruction may be used to 

define xx in the above labels . 



Disk Record Holding Area. A work area, used by 
the 1301 IOCS, in which records obtained from disk 

storage are temporarily retained for processir^ 

and/or subsequent return to disk storage. 



Disk Routine. A series of object -program instruc- 
tions needed to obtain or process disk-storage data. 



Holding 



A body of control 



information 



performed by a GETS or PUTS macro-instruction. 

This information must be entered into core storage 

— in an area reserved by the programmer for this 

purpose — before the associated macro-instruction 

is encountered by the program. 



information 



disk storage for use in a RANDOM PROCESSING 
application. 



Random Processing. Processing of disk records of 
uniform format and belonging to specific files in any 
(arbitrary) order of addresses. 



Sequen tial Processing . Processing of disk records 

in the order of ascending addresses. 



Single -Reference Processing . Processing of disk 

records of any format (and located anywhere in disk 

storage) in any (arbitrary) order of addresses. 



Stacking A 



•ea . A work area used by 

the 1301 IOCS to store transaction records for sub- 
sequent processing and updating by the Disk Rou- 
tine (s). 



r 



Disk Operation 
to be performed 



SEEK only 

WRITE Disk Check 

Wrong -Length -Record Check 
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Figure 91. BCD Characters 
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